No momento, esta página não está disponível em português
Marketpay icon

Verification codes

Capabilities error and remediation codes that you might receive in the webhook or API response.

When a screening error occurs, Adyen informs you through webhooks or API responses. These codes provide information such as which checks failed and what your seller can do to fix the errors. You can use these codes to build your screening error handling flows.

  • Remediating action codes: Provides possible solutions to fix a screening error. Whenever possible, Adyen sends a remediating action for every error.
  • General error codes: Provides a broad description of the cause of the screening error.
  • Specific suberror codes: Provides a more granular and specific cause of the screening error. Suberrors are linked to the general error codes.

Recommendations

We recommend that you build your error handling flows using the codes that best fit your use cases and available development resources.

Using all the codes—general errors, suberrors, and remediating actions—allows you to help sellers fix issues while also providing them more information about an error. However, doing this requires the most work because your implementation must be able to handle all possible error codes.

Alternatively, you can use only the remediating actions to help your sellers solve issues. This requires less work because there are less remediating action codes to map in your implementation, but these codes alone do not provide details about an error.

Problems array example

When a screening error occurs, you get information from the problems array. This array contains the following:

  • entity object: The ID of the legal entity that has an error.
  • verificationErrors array: Contains the details of the errors. Each item contains:
    • type: The type of error. Possible values are invalidInput and dataMissing.
    • code: The general error code.
    • message: The general error message.
    • remediatingActions: This object is sent when there is a common remediating action in the suberrors. This contains a code and message.
    • subErrors array. Each entry contains a type, code, message, and a remediatingActions array.

Próximas etapas

Build your error handling flows using the codes below.