---
updatedAt: 2026-05-17T01:46:48.000Z
agentTools:
projectIndex: https://docs.infiniaweb.com/llms.txt
---
# Bank account validation updated
Sent when a bank account validation changes status (`IN_PROGRESS` → `SUCCESSFUL`, `ERROR`, `TEMPORARY_FAILURE`, etc.). Set the destination URL using `callback_url` when creating the validation. The body is identical to the [Get Bank Account Validation](ref:v1_get_account_identity__id___get) response.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "Bank Account Validation",
"description": "Easily verify bank accounts globally with our single API solution.",
"version": "0.1.0"
},
"servers": [
{
"url": "https://app2test.infiniaweb.com/infinia_api/v1/bank-account-validation",
"description": "Sandbox"
}
],
"components": {
"schemas": {
"AccountDataArgentina": {
"properties": {
"number": {
"title": "Number",
"description": "Account number",
"type": "string"
},
"currency": {
"title": "Currency",
"description": "Account currency",
"type": "string",
"enum": [
"ARS",
"USD"
]
},
"type": {
"title": "Type",
"description": "Account type",
"type": "string",
"enum": [
"CA",
"CC",
"WALLET"
]
}
},
"type": "object",
"title": "Argentina"
},
"AccountDataBrazil": {
"properties": {
"number": {
"title": "Number",
"description": "Account number",
"type": "string"
},
"type": {
"title": "Type",
"description": "Account type",
"type": "string",
"enum": [
"SVGS",
"CHCK",
"CACC",
"SLRY",
"TRAN"
]
},
"currency": {
"type": "string",
"title": "Currency",
"description": "Account currency in ISO 4217 format. Always BRL",
"default": "BRL",
"enum": [
"BRL"
]
},
"bankName": {
"title": "Bankname",
"description": "Bank name",
"type": "string"
},
"bankCode": {
"title": "Bankcode",
"description": "Bank code in ISPB format",
"type": "string"
}
},
"type": "object",
"title": "Brazil"
},
"AccountDataColombia": {
"properties": {
"number": {
"title": "Number",
"description": "Account number / key value",
"type": "string"
},
"accountHolderName": {
"title": "Accountholdername",
"description": "Account holder name",
"type": "string"
},
"accountHolderIdNumber": {
"title": "Accountholderidnumber",
"description": "Account holder ID number",
"type": "string"
},
"bankCode": {
"title": "Bankcode",
"description": "Code of the bank the account or key belongs to",
"type": "string"
},
"bankName": {
"title": "Bankname",
"description": "Name of the bank the account or key belongs to",
"type": "string"
}
},
"type": "object",
"title": "Colombia"
},
"AccountDataGreatBritain": {
"properties": {
"currency": {
"title": "Currency",
"description": "Account currency in ISO 4217 format",
"type": "string"
}
},
"type": "object",
"title": "United Kingdom"
},
"AccountDataIndia": {
"properties": {
"number": {
"title": "Number",
"description": "Account number",
"type": "string"
},
"currency": {
"title": "Currency",
"description": "Account currency in ISO 4217 format",
"type": "string"
}
},
"type": "object",
"required": [
"number"
],
"title": "India"
},
"AccountDataMexico": {
"properties": {
"number": {
"title": "Number",
"description": "Account number",
"type": "string"
},
"bankCode": {
"title": "Bankcode",
"description": "Bank code",
"type": "string"
},
"bankName": {
"title": "Bankname",
"description": "Bank name",
"type": "string"
}
},
"type": "object",
"title": "Mexico"
},
"AccountDataPakistan": {
"properties": {
"currency": {
"title": "Currency",
"description": "Account currency in ISO 4217 format",
"type": "string"
}
},
"type": "object",
"title": "Pakistan"
},
"AccountDataPeru": {
"properties": {
"number": {
"title": "Number",
"description": "CCI of the account",
"type": "string"
},
"currency": {
"title": "Currency",
"description": "Account currency in ISO 4217 format",
"type": "string"
},
"type": {
"title": "Type",
"description": "Account type",
"type": "string",
"enum": [
"SVGS",
"CHCK"
]
}
},
"type": "object",
"title": "Peru"
},
"AccountDataSouthKorea": {
"properties": {
"currency": {
"title": "Currency",
"description": "Account currency in ISO 4217 format",
"type": "string"
}
},
"type": "object",
"title": "South Korea"
},
"AccountDataUnitedStates": {
"properties": {
"number": {
"type": "string",
"title": "Number",
"description": "Account number"
},
"routingNumber": {
"type": "string",
"title": "Routingnumber",
"description": "Routing number"
}
},
"type": "object",
"title": "United States"
},
"AccountDataUruguay": {
"properties": {
"number": {
"title": "Number",
"description": "Account number",
"type": "string"
},
"currency": {
"title": "Currency",
"description": "Account currency in ISO 4217 format",
"type": "string"
},
"type": {
"title": "Type",
"description": "Account type",
"type": "string",
"enum": [
"SVGS",
"CHCK"
]
}
},
"type": "object",
"title": "Uruguay"
},
"AccountDataVietnam": {
"properties": {
"currency": {
"title": "Currency",
"description": "Account currency in ISO 4217 format",
"type": "string"
}
},
"type": "object",
"title": "Vietnam"
},
"AccountIdentityResponseArgentina": {
"properties": {
"account": {
"$ref": "#/components/schemas/AccountDataArgentina",
"description": "Account information"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataArgentina"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
}
},
"type": "object",
"required": [
"account",
"owners"
],
"title": "Argentina"
},
"AccountIdentityResponseBangladesh": {
"properties": {
"matchScore": {
"title": "Matchscore",
"description": "A numerical representation of the similarity between the provided owner name and the actual owner of the account.",
"type": "number"
}
},
"type": "object",
"title": "Bangladesh"
},
"AccountIdentityResponseBrazil": {
"properties": {
"account": {
"$ref": "#/components/schemas/AccountDataBrazil",
"description": "Account information"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataBrazil"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
}
},
"type": "object",
"required": [
"account",
"owners"
],
"title": "Brazil"
},
"AccountIdentityResponseChina": {
"properties": {
"matchScore": {
"title": "Matchscore",
"description": "A numerical representation of the similarity between the provided owner name and the actual owner of the account.",
"type": "number"
}
},
"type": "object",
"title": "China"
},
"AccountIdentityResponseColombia": {
"properties": {
"account": {
"$ref": "#/components/schemas/AccountDataColombia",
"description": "Account information"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataColombia"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
}
},
"type": "object",
"required": [
"account",
"owners"
],
"title": "Colombia"
},
"AccountIdentityResponseGreatBritain": {
"properties": {
"account": {
"$ref": "#/components/schemas/AccountDataGreatBritain",
"description": "Account information"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataGreatBritain"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
}
},
"type": "object",
"required": [
"account",
"owners"
],
"title": "United Kingdom"
},
"AccountIdentityResponseIndia": {
"properties": {
"account": {
"$ref": "#/components/schemas/AccountDataIndia",
"description": "Account information"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataIndia"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
},
"matchScore": {
"title": "Matchscore",
"description": "A numerical representation of the similarity between the provided owner name and the actual owner of the account.",
"type": "number"
}
},
"type": "object",
"required": [
"account",
"owners"
],
"title": "India"
},
"AccountIdentityResponseIndonesia": {
"properties": {
"matchScore": {
"title": "Matchscore",
"description": "A numerical representation of the similarity between the provided owner name and the actual owner of the account.",
"type": "number"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataIndonesia"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
}
},
"type": "object",
"required": [
"owners"
],
"title": "Indonesia"
},
"AccountIdentityResponseMexico": {
"properties": {
"account": {
"$ref": "#/components/schemas/AccountDataMexico",
"description": "Account information"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataMexico"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
}
},
"type": "object",
"required": [
"account",
"owners"
],
"title": "Mexico"
},
"AccountIdentityResponseNepal": {
"properties": {
"matchScore": {
"title": "Matchscore",
"description": "A numerical representation of the similarity between the provided owner name and the actual owner of the account.",
"type": "number"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataNepal"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
}
},
"type": "object",
"required": [
"owners"
],
"title": "Nepal"
},
"AccountIdentityResponseNigeria": {
"properties": {
"matchScore": {
"title": "Matchscore",
"description": "A numerical representation of the similarity between the provided owner name and the actual owner of the account.",
"type": "number"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataNigeria"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
}
},
"type": "object",
"required": [
"owners"
],
"title": "Nigeria"
},
"AccountIdentityResponsePakistan": {
"properties": {
"account": {
"$ref": "#/components/schemas/AccountDataPakistan",
"description": "Account information"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataPakistan"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
}
},
"type": "object",
"required": [
"account",
"owners"
],
"title": "Pakistan"
},
"AccountIdentityResponsePeru": {
"properties": {
"account": {
"$ref": "#/components/schemas/AccountDataPeru",
"description": "Account information"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataPeru"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
}
},
"type": "object",
"required": [
"account",
"owners"
],
"title": "Peru"
},
"AccountIdentityResponseSouthKorea": {
"properties": {
"matchScore": {
"title": "Matchscore",
"description": "A numerical representation of the similarity between the provided owner name and the actual owner of the account.",
"type": "number"
},
"account": {
"$ref": "#/components/schemas/AccountDataSouthKorea",
"description": "Account information"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataSouthKorea"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
}
},
"type": "object",
"required": [
"account",
"owners"
],
"title": "South Korea"
},
"AccountIdentityResponseUnitedStates": {
"properties": {
"account": {
"$ref": "#/components/schemas/AccountDataUnitedStates",
"description": "Account information"
},
"owners": {
"title": "Owners",
"description": "Owners information",
"items": {
"$ref": "#/components/schemas/OwnerDataUnitedStates"
},
"type": "array"
}
},
"type": "object",
"title": "United States"
},
"AccountIdentityResponseUruguay": {
"properties": {
"account": {
"$ref": "#/components/schemas/AccountDataUruguay",
"description": "Account information"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataUruguay"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
}
},
"type": "object",
"required": [
"account",
"owners"
],
"title": "Uruguay"
},
"AccountIdentityResponseVietnam": {
"properties": {
"matchScore": {
"title": "Matchscore",
"description": "A numerical representation of the similarity between the provided owner name and the actual owner of the account.",
"type": "number"
},
"account": {
"$ref": "#/components/schemas/AccountDataVietnam",
"description": "Account information"
},
"owners": {
"items": {
"$ref": "#/components/schemas/OwnerDataVietnam"
},
"type": "array",
"title": "Owners",
"description": "Owners information"
}
},
"type": "object",
"required": [
"account",
"owners"
],
"title": "Vietnam"
},
"EnrichedOwnerDataBrazil": {
"properties": {
"ownerName": {
"title": "Ownername",
"description": "Account owner name",
"type": "string"
},
"dateOfBirth": {
"title": "Dateofbirth",
"description": "Date of birth of the account owner, if a natural person. In the format YYYYMMDD",
"type": "string"
},
"isMinor": {
"title": "Isminor",
"description": "Indicates whether the account owner, if a natural person, is under the age of majority",
"type": "boolean"
},
"isDeceased": {
"title": "Isdeceased",
"description": "Indicates whether the account owner, if a natural person, is deceased",
"type": "boolean"
},
"dateOfDeath": {
"title": "Dateofdeath",
"description": "Date when the account owner, if a natural person, passed away",
"type": "string"
}
},
"type": "object",
"title": "EnrichedOwnerDataBrazil"
},
"OwnerDataArgentina": {
"properties": {
"name": {
"title": "Name",
"description": "Account owner name",
"type": "string"
},
"type": {
"title": "Type",
"description": "Account owner type",
"type": "string",
"enum": [
"NATURAL",
"LEGAL"
]
},
"documentType": {
"title": "Documenttype",
"description": "Account owner document type",
"type": "string",
"enum": [
"DNI",
"CUIT"
]
},
"documentNumber": {
"title": "Documentnumber",
"description": "Account owner document number",
"type": "string"
}
},
"type": "object",
"required": [
"documentType",
"documentNumber"
],
"title": "OwnerDataArgentina"
},
"OwnerDataBrazil": {
"properties": {
"name": {
"title": "Name",
"description": "Account owner name",
"type": "string"
},
"type": {
"title": "Type",
"description": "Account owner type",
"type": "string",
"enum": [
"NATURAL",
"LEGAL"
]
},
"documentType": {
"title": "Documenttype",
"description": "Account owner document type",
"type": "string",
"enum": [
"CNPJ",
"CPF"
]
},
"documentNumber": {
"title": "Documentnumber",
"description": "Account owner document number",
"type": "string"
},
"enrichedOwnerData": {
"description": "Enriched owner data from external sources",
"$ref": "#/components/schemas/EnrichedOwnerDataBrazil"
}
},
"type": "object",
"title": "OwnerDataBrazil"
},
"OwnerDataColombia": {
"properties": {
"name": {
"title": "Name",
"description": "Account owner name",
"type": "string"
},
"type": {
"title": "Type",
"description": "Account owner type",
"type": "string",
"enum": [
"NATURAL",
"LEGAL"
]
},
"documentType": {
"title": "Documenttype",
"description": "Account owner document type (e.g. CC, NIT).",
"type": "string"
},
"documentNumber": {
"title": "Documentnumber",
"description": "Account owner document number",
"type": "string"
}
},
"type": "object",
"title": "OwnerDataColombia"
},
"OwnerDataGreatBritain": {
"properties": {
"name": {
"title": "Name",
"description": "Account owner name (only returned if an ownerName was provided and it partially matches the owner name in the bank)",
"type": "string"
}
},
"type": "object",
"required": [
"name"
],
"title": "OwnerDataGreatBritain"
},
"OwnerDataIndia": {
"properties": {
"name": {
"title": "Name",
"description": "Account owner name",
"type": "string"
}
},
"type": "object",
"required": [
"name"
],
"title": "OwnerDataIndia"
},
"OwnerDataIndonesia": {
"properties": {
"name": {
"title": "Name",
"description": "Account owner name.",
"type": "string"
}
},
"type": "object",
"required": [
"name"
],
"title": "OwnerDataIndonesia"
},
"OwnerDataMexico": {
"properties": {
"name": {
"title": "Name",
"description": "Account owner name",
"type": "string"
},
"type": {
"title": "Type",
"description": "Account owner type",
"type": "string",
"enum": [
"NATURAL",
"LEGAL"
]
},
"documentType": {
"title": "Documenttype",
"description": "Account owner document type",
"type": "string",
"enum": [
"RFC",
"CURP"
]
},
"documentNumber": {
"title": "Documentnumber",
"description": "Account owner document number",
"type": "string"
}
},
"type": "object",
"required": [
"type",
"documentType",
"documentNumber"
],
"title": "OwnerDataMexico"
},
"OwnerDataNepal": {
"properties": {
"name": {
"title": "Name",
"description": "Account owner name",
"type": "string"
}
},
"type": "object",
"required": [
"name"
],
"title": "OwnerDataNepal"
},
"OwnerDataNigeria": {
"properties": {
"name": {
"title": "Name",
"description": "Account owner name",
"type": "string"
}
},
"type": "object",
"required": [
"name"
],
"title": "OwnerDataNigeria"
},
"OwnerDataPakistan": {
"properties": {
"name": {
"title": "Name",
"description": "Account owner name",
"type": "string"
}
},
"type": "object",
"required": [
"name"
],
"title": "OwnerDataPakistan"
},
"OwnerDataPeru": {
"properties": {
"name": {
"title": "Name",
"description": "Account owner name",
"type": "string"
},
"type": {
"title": "Type",
"description": "Account owner type",
"type": "string",
"enum": [
"NATURAL",
"LEGAL"
]
},
"documentType": {
"title": "Documenttype",
"description": "Account owner document type",
"type": "string",
"enum": [
"DNI",
"RUC",
"CE",
"PAS"
]
},
"documentNumber": {
"title": "Documentnumber",
"description": "Account owner document number",
"type": "string"
}
},
"type": "object",
"title": "OwnerDataPeru"
},
"OwnerDataSouthKorea": {
"properties": {
"name": {
"title": "Name",
"description": "Account owner name",
"type": "string"
},
"nameTranslation": {
"title": "Nametranslation",
"description": "Account owner name translation",
"type": "string"
}
},
"type": "object",
"required": [
"name",
"nameTranslation"
],
"title": "OwnerDataSouthKorea"
},
"OwnerDataUnitedStates": {
"properties": {
"name": {
"type": "string",
"title": "Name",
"description": "Account owner name"
}
},
"type": "object",
"title": "OwnerDataUnitedStates"
},
"OwnerDataUruguay": {
"properties": {
"name": {
"type": "string",
"title": "Name",
"description": "Account owner name"
},
"type": {
"title": "Type",
"description": "Account owner type",
"type": "string",
"enum": [
"NATURAL",
"LEGAL"
]
},
"documentType": {
"title": "Documenttype",
"description": "Account owner document type",
"type": "string",
"enum": [
"CI",
"RUT",
"PASSPORT"
]
},
"documentNumber": {
"title": "Documentnumber",
"description": "Account owner document number",
"type": "string"
}
},
"type": "object",
"title": "OwnerDataUruguay"
},
"OwnerDataVietnam": {
"properties": {
"name": {
"title": "Name",
"description": "Account owner name",
"type": "string"
}
},
"type": "object",
"required": [
"name"
],
"title": "OwnerDataVietnam"
},
"QRValidationResponseArgentina": {
"properties": {
"cuil": {
"title": "Cuil",
"description": "CUIL of the QR receiver",
"type": "string"
},
"cvu": {
"title": "Cvu",
"description": "CVU of the QR receiver",
"type": "string"
},
"amount": {
"title": "Amount",
"description": "Amount of the QR (only for closed QRs)",
"type": "number"
},
"mcc": {
"title": "Mcc",
"description": "Merchant category code",
"type": "string"
},
"type": {
"title": "Type",
"description": "QR type",
"type": "string",
"enum": [
"open",
"closed"
]
},
"holder": {
"title": "Holder",
"description": "Name of the QR receiver",
"type": "string"
},
"accepter": {
"title": "Accepter",
"description": "QR accepter (only for closed QRs)",
"type": "string"
}
},
"type": "object",
"title": "Argentina QR"
},
"QRValidationResponseBrazil": {
"properties": {
"type": {
"title": "Type",
"description": "QR type: static (the Pix key is in the QR) or dynamic (the QR points to a charge)",
"type": "string",
"enum": [
"static",
"dynamic"
]
},
"pixKey": {
"title": "Pixkey",
"description": "Pix key of the QR receiver (only for static QRs)",
"type": "string"
},
"amount": {
"title": "Amount",
"description": "Amount of the QR, when it sets one",
"type": "number"
},
"expiration": {
"title": "Expiration",
"description": "Expiration of the charge (only for dynamic QRs)",
"type": "string"
},
"txid": {
"title": "Txid",
"description": "Transaction identifier set in the QR (only for static QRs)",
"type": "string"
},
"holder": {
"title": "Holder",
"description": "Name of the QR receiver, as registered in DICT",
"type": "string"
},
"holderDocument": {
"title": "Holderdocument",
"description": "CPF/CNPJ of the QR receiver, as registered in DICT. A CPF comes partially masked",
"type": "string"
},
"bankName": {
"title": "Bankname",
"description": "Bank of the QR receiver",
"type": "string"
},
"bankCode": {
"title": "Bankcode",
"description": "Bank of the QR receiver in ISPB format",
"type": "string"
}
},
"type": "object",
"title": "Brazil QR"
},
"QRValidationResponsePeru": {
"properties": {
"cci": {
"title": "Cci",
"description": "CCI the QR credits",
"type": "string"
},
"holder": {
"title": "Holder",
"description": "Name of the QR receiver",
"type": "string"
},
"amount": {
"title": "Amount",
"description": "Amount of the QR (only for closed QRs)",
"type": "number"
},
"currency": {
"title": "Currency",
"description": "Currency of the QR in ISO 4217 format",
"type": "string"
},
"mcc": {
"title": "Mcc",
"description": "Merchant category code",
"type": "string"
},
"type": {
"title": "Type",
"description": "QR type",
"type": "string",
"enum": [
"open",
"closed"
]
}
},
"type": "object",
"title": "Peru QR"
},
"UnifiedResponse": {
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"country": {
"type": "string",
"enum": [
"AR",
"BD",
"BR",
"CN",
"CO",
"ES",
"GB",
"ID",
"IN",
"INTL",
"KR",
"MX",
"NG",
"NP",
"PE",
"PK",
"US",
"UY",
"VN"
],
"title": "Country",
"description": "Country"
},
"createdAt": {
"type": "string",
"format": "date-time",
"title": "Createdat",
"description": "Record creation date"
},
"updatedAt": {
"type": "string",
"format": "date-time",
"title": "Updatedat",
"description": "Record update date"
},
"inputData": {
"additionalProperties": true,
"type": "object",
"title": "Inputdata",
"description": "Data entered to create the record"
},
"status": {
"type": "string",
"enum": [
"SUCCESSFUL",
"IN_PROGRESS",
"ERROR",
"TEMPORARY_FAILURE"
],
"title": "Status",
"description": "Status of the validation process.
- SUCCESSFUL: The validation process ended correctly. The account was found and the associated data is available to query. It's up to the caller to validate if the data matches the expected values.
- IN_PROGRESS: The validation process is still in progress, keep querying for the result.
- ERROR: The validation process ended with an error. The account was not found and the associated data is not available to query.
- TEMPORARY_FAILURE: The validation process ended with an error. The error is temporary and you may retry it later."
},
"statusDescription": {
"title": "Statusdescription",
"description": "Verbose description/explanation of the status",
"type": "string"
},
"countryData": {
"anyOf": [
{
"$ref": "#/components/schemas/AccountIdentityResponseArgentina"
},
{
"$ref": "#/components/schemas/QRValidationResponseArgentina"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseBangladesh"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseBrazil"
},
{
"$ref": "#/components/schemas/QRValidationResponseBrazil"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseChina"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseColombia"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseIndia"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseIndonesia"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseMexico"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseNepal"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseNigeria"
},
{
"$ref": "#/components/schemas/AccountIdentityResponsePakistan"
},
{
"$ref": "#/components/schemas/AccountIdentityResponsePeru"
},
{
"$ref": "#/components/schemas/QRValidationResponsePeru"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseSouthKorea"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseGreatBritain"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseUnitedStates"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseUruguay"
},
{
"$ref": "#/components/schemas/AccountIdentityResponseVietnam"
}
],
"title": "Countrydata",
"description": "Country specific data obtained from the validation process"
}
},
"type": "object",
"required": [
"id",
"country",
"createdAt",
"updatedAt",
"inputData",
"status"
],
"title": "Succesful response"
},
"UnifiedResponseWrapper": {
"properties": {
"status": {
"type": "string",
"title": "Status",
"default": "success",
"enum": [
"success"
]
},
"data": {
"$ref": "#/components/schemas/UnifiedResponse"
}
},
"type": "object",
"required": [
"data"
],
"title": "UnifiedResponseWrapper"
}
}
},
"webhooks": {
"bank_account_validation.updated": {
"post": {
"operationId": "v1_webhook_bank_account_validation_updated",
"summary": "Bank account validation updated",
"description": "Sent when a bank account validation changes status (`IN_PROGRESS` → `SUCCESSFUL`, `ERROR`, `TEMPORARY_FAILURE`, etc.). Set the destination URL using `callback_url` when creating the validation. The body is identical to the [Get Bank Account Validation](ref:v1_get_account_identity__id___get) response.",
"tags": [
"Webhooks"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnifiedResponseWrapper"
},
"example": {
"status": "success",
"data": {
"id": "bav_01HXYZ",
"country": "BR",
"status": "SUCCESSFUL",
"statusDescription": "Validation completed successfully",
"createdAt": "2024-05-30T10:00:00Z",
"updatedAt": "2024-05-30T10:05:00Z",
"inputData": {
"pixKey": "12345678900"
},
"countryData": {
"ownerData": {
"name": "John Doe",
"taxId": "12345678900"
},
"accountData": {
"pixKey": "12345678900",
"bank": "Nubank"
}
}
}
}
}
}
},
"responses": {
"200": {
"description": "Any 2xx response is treated as a successful acknowledgement. Infinia will retry delivery on non-2xx responses."
}
}
}
}
}
}
```