Account verification helps you confirm beneficiary account details before processing payments. This service communicates directly with banking systems to verify account details across multiple countries.

This feature provides several benefits:

  • Improves user trust during payment setup by confirming recipient details
  • Prevents failed payments due to name mismatches on the recipient bank side
  • Reduces fraud risk by verifying recipient identity before funds transfer

Account verification is currently an experimental feature with expanding country coverage. The rollout plan includes:

  • June 2025: 8 Latin American countries (Argentina, Brazil, Chile, Colombia, Ecuador, Mexico, Peru, Uruguay)
  • Future releases: India, South Africa, and USA

​
Submit account verification request

Submit a payment instruction to initiate account verification. The endpoint immediately returns a PENDING account verification object, allowing you to track the verification progress by its ID.

POST /payments/verifications

Request
{
  "country": "AR",
  "creditorAccount": {
    "id": {
      "value": "0300056410000438550019",
      "type": "ACCOUNT_NUMBER"
    }
  }
}
Response
  {
    "id": "e6ed0b15-aace-4344-83a7-cf477b3c6dc8",
    "createdAt": "2025-06-13T11:07:42Z",
    "updatedAt": "2025-06-13T11:07:42Z",
    "state": "PENDING"
  }

Before initiating the verification process, the API validates your request to ensure it contains all required fields and properly formatted data for the specified country. If any mandatory fields are missing or incorrectly formatted, the verification cannot proceed successfully. In such cases, the API returns a 400 Bad Request error immediately instead of accepting an account verification request.

Error response
{
  "code": "ACCOUNT_VERIFICATION_MISSING_REQUIRED_FIELD",
  "message": "Identification document is required for account verification in BR"
}

Before submitting account verification requests, we recommend using the payment validation endpoint. This validation step helps ensure your verification request has the best chance of acceptance and provides immediate feedback on any formatting issues.

​
Real-time updates

To stay informed about the progress of your account verification requests, we recommend setting up webhooks and subscribing to account verification event types. This ensures your system is immediately notified when verification requests are submitted and when results become available.

Available event types:

  • ACCOUNT_VERIFICATION.SUBMITTED - triggered when a verification request is submitted
  • ACCOUNT_VERIFICATION.COMPLETED - triggered when verification finishes with a result
  • ACCOUNT_VERIFICATION.FAILED - triggered when verification fails

For detailed instructions on how to set up and manage webhooks, please refer to our webhooks guide.

​
Retrieve account verification result

Check the status and result of an account verification using the verification ID returned from the submission request.

GET /payments/verifications/{verificationId}

Response
{
  "id": "e6ed0b15-aace-4344-83a7-cf477b3c6dc8",
  "createdAt": "2025-06-13T11:07:42Z",
  "updatedAt": "2025-06-13T11:09:13Z",
  "state": "COMPLETED",
  "result": {
    "accountStatus": "VALID",
    "accountHolderName": {
      "verifiedName": "Fabio Mansilla"
    }
  }
}

​
Country specifications

Each country has specific coverage levels, field requirements, and formatting standards. Some countries only require the account number to perform verification, while others require additional information such as bank codes, account types, and beneficiary identification document numbers. Some countries support beneficiary name disclosure, while others only provide name matching without exposing the actual account holder name.

​
Beneficiary name verification options

Account verification provides three different approaches for handling beneficiary names. The available options depend on the country’s regulations - some countries support full name disclosure, while others only allow name matching without revealing the actual account holder name.

Request
{
  "country": "AR",
  "creditorAccount": {
    "id": {
      "value": "0300056410000438550019",
      "type": "ACCOUNT_NUMBER"
    }
  }
}
Response
{
  "result": {
    "accountStatus": "VALID",
    "accountHolderName": {
      "verifiedName": "Fabio Mansilla"
    }
  }
}