Get Account Info

Validates account ownership and existence using a CBU, CVU, or Alias.

Description

The Get Account Info endpoint allows merchants in Argentina to validate a bank account’s ownership using a CBU, CVU, or Alias, without executing a payout. This service helps ensure account authenticity, improve user conversion, and meet regulatory requirements—particularly relevant for industries such as gambling, where it’s essential to verify that deposits are made to the player’s own account.

Considerations

• Geographic scope: Currently available only for Argentina (country = ARG).

• Payment keys: Only valid for CBU, CVU, or Alias.

• Functional scope: This service does not trigger any payout flow.

• Authentication: Accessible via POST under Monnet’s standard authentication scheme.

• Rate limit: Limited to 60 requests per minute (TPM); additional requests will be rejected.

Input Parameters

Endpoint Production: https://api.payout.monnet.io/ms-payouts-scanning-entities/api/v1/scanning/account-info

Endpoint Certification: https://cert.api.payout.monnet.io/ms-payouts-scanning-entities/api/v1/scanning/account-info

The request must include the following fields:

Field	Type	Mandatory	Description	Format / Example
first_name	string	Yes	Account holder’s first name	Maximum length: 255 characters (general rule) / Rodrigo
last_name	string	Yes	Account holder’s last name	Maximum length: 255 characters (general rule) / Suarez
document_type	intiger	Yes	Type of identification document	Possible values: 1, 2 or 3
document_number	string	Yes	Identification document number	For Argentina: 7–13 characters allowed, depending on document type: • CUIL: 11–13 • CUIT: 11–13 • DNI: 7–8
account_identifier	string	Yes	Account to be validated	For Argentina: 6–22 characters allowed, depending on account type: • Alias: 6–20 • CBU: 22 • CVU: 22
country	string	Yes	Country (ISO) . For this scope, only ARG (Argentina) is accepted.	Length: 3 characters, ISO format (3166-1-alpha-3)

Example Request

{
"first_name": "Rodrigo",
"last_name": "Suarez",
"document_type": "DNI",
"document_number": "12345678",
"account_identifier": "1230001312000001234567",
"country": "ARG"
}

Response

Field	Format	Description
code	string	Indicates the status of the validation process. If the validation is successful, the returned value is “200”.
title	string	Description associated with the result code
validated_ holders	Array	Array of objects representing the validated account holders
validated_ name	string	Validated account holder’s name
validated_ documentt ype	string	Validated account holder’s document type (For Argentina: CUIT/CUIL)
validated_ document	string	Validated account holder’s identification document number
account_id entifier	string	Validated account number (For Argentina: CBU/CVU)
bank_name	string	Name of the financial institution or PSP to which the account belongs

Examples Response

a. Example response when the account exists and matches the account holder:

{
  "code": 200,
  "title": "Identity verification successful.",
  "validated_holders": [
    {
      "validated_name": "Juan Paredes",
      "validated_documenttype": "CUIT",
      "validated_document": "20123456789"
    }
  ],
  "account_identifier": "1230001312000001234567",
  "bank_name": "BANCO HSBC"
}

b. Example response when the account exists and corresponds to more than one account holder:

{
  "code": 200,
  "title": "Identity verification successful.",
  "validated_holders": [
    {
      "validated_name": "Juan Paredes",
      "validated_documenttype": "CUIT",
      "validated_document": "20123456789"
    },
    {
      "validated_name": "Mario Gonzales",
      "validated_documenttype": "CUIT",
      "validated_document": "27234567890"
    }
  ],
  "account_identifier": "1230001312000001234567",
  "bank_name": "BANCO HSBC"
}

c. If the beneficiary’s data does not match the validated account holder or co-holder:

{
  "code": "GAI0007",

  "title": "Not found",

  "status": "404",

  “detail”: “Beneficiary is not the Account Owner. The provided document_number does not match the account owner or any co-owners.”
}

d. If the submitted account is inactive or does not exist, and its data cannot be validated.

{
  "code": "GAI0006",

  "title": "Inactive account",

  "status": "422",

  “detail”: “The account is inactive. Validation
  cannot proceed.”
  }

Error Codes

Below are the error codes that the Get Account Info service may return:

Error Codes	Title	Detail
GAI0001	Bad Request	One or more fields in the request do not meet the required validations. Please review the submitted parameters.
GAI0002	Bad Request	Country not available. Please review the submitted parameter.
GAI0003	Too Many Requests	The request has been rejected because the maximum number of allowed requests for this endpoint has been exceeded. Please try again later.
GAI0004	Service Unavailable	Network services are currently unavailable. All configured providers failed to respond after retry attempts. Please try again later
GAI0005	No providers available	The selected country is supported but has no enabled providers at this time. Please try again later or contact support.
GAI0006	Inactive account	The account is inactive. Validation cannot proceed.
GAI0007	Not found	Beneficiary is not the Account Owner. The provided document_number does not match the account owner or any co-owners.
GAI0008	Internal Server Error	An unexpected error occurred while processing the request. Please contact support if the issue persists.
GAI0009	Service Unavailable	Account Validating service is temporarily unavailable. Please try again later
GAI0010	Not found	Account identifier invalid or does not exist.
GAI0011	Not found	Alias not found or not registered.
GAI0012	Authentication failed	Authentication with the service failed. Please verify the provided credentials or contact support.