Account Verification Object

Verify an account holder's information by making a microdeposit (0.01 MXN) to their account.

{
  "id": "accv_fdsjklsdjkls",
  "object": "account_verification",
  "status": "succeeded",
  "reason": null,
  "transfer_id": "tr_fdskjldasjkl",
  "counterparty": {
    "account_number": "123456789123455789",
    "holder_id": "FLA1234567890", 
    "holder_name": "Carmen Marcela",
    "account_type": "clabe",
    "institution": {
      "id": "mx_banco_bbva",
      "name": "BBVA Mexico",
      "country": "mx" 
    }
  },
  "mode": "test",
  "receipt_url": "https://www.banxico.org.mx/cep/",
  "transaction_date": "2020-04-17T00:00:00.000Z"
}

Account Verification Object

FieldTypeDescription
idstringUnique identifier for the account verification.
objectstringThe type of the object, which is always account_verification.
statusstringThe status of the account verification. It can be pending, succeeded or failed.
reasonstringDetails on why the account verification was unsuccessful. Is null unless the microdeposit transfer is returned. Find all possible reasons here.
transfer_idstringUnique identifier for the microdeposit transfer used to verify the account.
counterpartyobjectInformation about the verified account holder. See details below.
modestringMode of the API (test or live).
receipt_urlstringA URL to the receipt of the transfer, if available.
transaction_datestringThe actual date when the transfer was initiated (YYYY-MM-DD format).

Counterparty Object (within Account Verification Object)

FieldTypeDescription
holder_idstringThe unique ID of the third party of the transaction (counterparty).
holder_namestringThe name of the third party of the transaction (counterparty).
account_numberstringThe account number (in Mexico: CLABE) of the third party of the transaction (counterparty).
account_typestringThe type of the counterparty account. In Mexico is one of: clabe, debit_card or phone_number. Options for Chile: checking, sight.
institutionobjectThe institution object containing details about the sender's financial institution.

Institution Object (within Counterparty)

FieldTypeDescription
idstringUnique identifier for the institution. See Chile Institution Codes or Mexico Institution Codes.
namestringThe name of the financial institution.
countrystringThe country where the financial institution is located (in ISO 3166-1 alpha-2 format, e.g., mx for Mexico).