Error table
The tables below present the possible errors that can be returned in the DDA flow APIs.
Subscription API Error Table: Registration and Deletion
Trying to register or delete a user in DDA.
| HTTP code | Error code | Error message | Resolution |
|---|---|---|---|
| 401 | CDDA301 | Unauthorized request | Product is not active on the account or authentication keys are incorrect. Please check authentication or contact support. |
| 403 | CDDA302 | Customer not authorized for the product | Product not active on account. Please contact your sales or support representative. |
| 400 | CDDA001 | Some mandatory field was not sent | To register users, it is mandatory to send the document (CPF or CNPJ) and the clientName (client name). |
| For deletion, the document (CPF or CNPJ) is a mandatory field. | |||
| If this error is returned, check if this data is being sent. | |||
| 400 | CDDA100 | Campos [clientName] e [document] inválidos | Invalid name and document, means that the field is being sent empty (ex: clientName: " "), or is sending incorrect types (ex: document: "abcd"), or incorrect number of digits (ex: document: "123") and etc. Check the data being sent in both fields. |
| 400 | CDDA100 | Invalid [clientName] field | This error shows that the username is being sent as empty (ex: clientName: " "). Check the clientName field that is being sent. |
| 400 | CDDA100 | Campo [document] inválido | This error shows that the user's document is being sent as empty, or has letters and other special characters, or has too many or too few digits. Check the data being sent in the document field. |
| 400 | CDDA100 | Campo [document] inválido | Document has some problem to be registered, try again later. If the error persists you should contact support to verify the anomaly. |
| 400 | CDDA101 | There is already a pending registration request for this document | The document sent in the registration request has already been sent before and the previous request is being processed, i.e., it has the PROCESSING status. Change the document or wait for the webhook from the first request to return. |
| 400 | CDDA102 | User already registered | The document provided has already been registered with the DDA, i.e., the status of this record is CREATED. Please provide a new document. |
| 400 | CDDA200 | It is not possible to register this document at this time. Please try again later. | A communication failure occurred. Please contact support. |
| 400 | CDDA103 | It is not possible to cancel a registration in progress | The document informed in the deletion request has not yet completed the registration process, that is, this document is in PROCESSING status and for deletion it must have CREATED status. Enter a new document or wait for the successful registration to return to delete the user. |
| 400 | CDDA104 | It is not possible to cancel this document | The document provided does not exist, i.e. it has not been registered. Please provide a new document or check the data being sent. |
| 500 | CDDA999 | An unexpected error occurred | Unexpected error. Please contact support to verify the anomaly. |
Boleto API error table
Attempt to generate payment slips.
| HTTP code | Error code | Error message | Resolution |
|---|---|---|---|
| 401 | CDDA301 | Unauthorized request | Product is not active on the account or authentication keys are incorrect. Please check authentication or contact support. |
| 403 | CDDA302 | Customer not authorized for the product | Product not active on account. Please contact your sales or support representative. |
| 400 | CDDA004 | The [document] field was not sent | This error is returned if the field is not sent in the request (e.g. { }). It is mandatory to send the document field. |
| 400 | CDDA115 | The request has a limit of up to 20 documents | This error is returned if more than 20 documents are sent in the request. Remove the excess documents sent and make a request for every 20 documents. |
| 400 | CDDA116 | The request must have at least one document | The field is mandatory and at least 1 valid document must be sent. This error is returned if the field is sent like this: { "document": [ ] }. Check the data sent. |
| 400 | CDDA117 | Each document must contain only numbers | This error is returned when the data sent contains letters or symbols, or when it is not sent (e.g. {"document": ["121312asfdf"]} or {"document": [" "]}). Check the document field and send numeric digits. |
| 400 | CDDA118 | The CPF must contain 11 numeric characters and the CNPJ must contain 14 numeric characters | Returned when more than 11 digits are sent for CPF or 14 digits for CNPJ. Or when random digits are sent that are not a CPF/CNPJ (ex: {"document": ["12345678911"]}). Check the data sent in the document field and try again. |
| 500 | CDDA999 | An unexpected error occurred | Unexpected error. Please contact support to verify the anomaly. |
Webhooks API Error Table
Attempting to configure webhooks to receive notifications from DDA.
| HTTP code | Error code | Error message | Resolution |
|---|---|---|---|
| 401 | CDDA301 | Unauthorized request | Product is not active on the account or authentication keys are incorrect. Please check authentication or contact support. |
| 403 | CDDA302 | Customer not authorized for the product | Product not active on account. Please contact your sales or support representative. |
| 400 | CDDA002 | Some field required for sending the webhook was not provided | Error returned if typeEventWebhook and url fields are not sent. Check these fields and try again. |
| 400 | CDDA003 | Some field required for authentication was not provided | For basicAuthentication authentication, it is mandatory to send the fields: identification and password. For oAuthTwo authentication, it is mandatory to send the fields: endpoint, grantType, clientId and clientSecret. This error is returned if any of the mentioned fields are not being sent, check the request and try again. |
| 400 | CDDA105 | Selecione um tipo de evento [Subscription, Deletion, Invoice] | This error is returned when no event is reported in the typeEventWebhook field. (Ex: typeEventWebhook: " ") |
| Please check the data sent and try again. | |||
| 400 | CDDA115 | You can only register one event at a time. | Returned when more than one event is reported in the field (Ex: typeEventWebhook: "Deletion, Invoice "). Use one request for each event configuration. |
| 400 | CDDA106 | Choose only one authentication type | You can only use one authentication at a time, either basicAuthentication or oAuthTwo. Make sure both authentications are being sent in the same request. |
| 400 | CDDA100 | Invalid field [{field}] | Returned when the value entered in the field does not match. (Ex: typeEventWebhook: "Delete" or typeEventWebhook: "1"). It is only possible to register: Deletion, Subscription or Invoice. |
| 400 | CDDA100 | Invalid [Url] field | Returned when the value entered in the field does not match. (Ex: url: " " or url: "aa"). Check the data sent and try again. |
| 400 | CDDA100 | Campo [identification] inválido | Returned when no data is entered in this field (Ex: identification: " "). Check the field and try again. |
| 400 | CDDA100 | Campo [password] inválido | Returned when no data is entered in this field (Ex: password: " "). Check the field and try again. |
| 400 | CDDA100 | Invalid [endpoint] field | Returned when no data is entered in this field (Ex: endpoint: " "). Check the field and try again. |
| 400 | CDDA100 | Invalid [grantType] field | Returned when no data is entered in this field (Ex: grandType: " "). Check the field and try again. |
| 400 | CDDA100 | Invalid [clientId] field | Returned when no data is entered in this field (Ex: clientId: " "). Check the field and try again. |
| 400 | CDDA100 | Invalid [clientSecret] field | Returned when no data is entered in this field (Ex: clientSecret: " "). Check the field and try again. |
| 500 | CDDA999 | An unexpected error occurred | Unexpected error. Please contact support to verify the anomaly. |