curl --request POST \
--url https://api.fintoc.com/v2/recipients \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"entity_id": "ent_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"account_number": "000000000000000000",
"holder_name": "Test Customer 1",
"holder_type": "person",
"holder_id": "111111111",
"alias": "Test recipient",
"email": "recipient@example.com"
}
'{
"id": "rcp_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"account_number": "000000000000000000",
"account_type": "clabe",
"alias": "Test recipient",
"created_at": "2026-03-01T12:00:00Z",
"email": "recipient@example.com",
"holder_id": "111111111",
"holder_name": "Test Customer 1",
"holder_type": "person",
"updated_at": "2026-03-01T12:00:00Z",
"object": "recipient",
"institution": {
"id": "40002",
"name": "BANAMEX",
"country": "mx"
}
}Create a recipient
Creates a recipient for an entity in your organization, in the live or test mode of your API key. In Chile, provide the Chilean tax ID (RUT), account_type, and holder_type. In Mexico, Fintoc infers account_type from account_number. Returns the created recipient.
curl --request POST \
--url https://api.fintoc.com/v2/recipients \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"entity_id": "ent_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"account_number": "000000000000000000",
"holder_name": "Test Customer 1",
"holder_type": "person",
"holder_id": "111111111",
"alias": "Test recipient",
"email": "recipient@example.com"
}
'{
"id": "rcp_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"account_number": "000000000000000000",
"account_type": "clabe",
"alias": "Test recipient",
"created_at": "2026-03-01T12:00:00Z",
"email": "recipient@example.com",
"holder_id": "111111111",
"holder_name": "Test Customer 1",
"holder_type": "person",
"updated_at": "2026-03-01T12:00:00Z",
"object": "recipient",
"institution": {
"id": "40002",
"name": "BANAMEX",
"country": "mx"
}
}Authorizations
Body
Identifier of the entity the recipient belongs to.
"ent_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA"
Destination bank account number. In Mexico, an 18-digit standardized Mexican bank account number (CLABE), a 16-digit debit card number, or a 10-digit mobile number. Digits only.
"000000000000000000"
Account holder name. Up to 40 characters.
"Test Customer 1"
Public identifier of the destination institution. Required in Chile. In Mexico, required for debit card and mobile numbers. For a valid CLABE, Fintoc derives the institution and you can omit this field.
"40002"
Destination account type. Required in Chile on create. One of checking_account, sight_account, or savings_account.
checking_account, sight_account, savings_account "checking_account"
Account holder identification. Required in Chile on create, as a valid Chilean tax ID (RUT). Send the value without dots, hyphens, or leading zeros, with an uppercase check digit. Cannot change after creation.
"111111111"
Account holder category. One of person or company. Required in Chile.
person, company "person"
Label you assign to the recipient.
"Test recipient"
Contact email address in name@example.com format. Up to 200 characters.
"recipient@example.com"
Response
The recipient object.
A recipient represents a saved destination account for an entity. The recipient contains the account holder, institution, and account details for the destination in Chile or Mexico.
Unique identifier of the recipient.
"rcp_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA"
Type of the object. Always recipient.
Destination bank account number. In Mexico, an 18-digit standardized Mexican bank account number (CLABE), a 16-digit debit card number, or a 10-digit mobile number.
"000000000000000000"
Destination account type, in lowercase. In Mexico, inferred from account_number. Returns null when unknown. One of clabe, debit_card, mobile, vostro_account, vostro_account1, vostro_account2, vostro_account3, vostro_account4, values_custody, institution, checking_account, sight_account, and savings_account.
clabe, debit_card, mobile, vostro_account, vostro_account1, vostro_account2, vostro_account3, vostro_account4, values_custody, institution, checking_account, sight_account, savings_account, null "clabe"
Label you assign to the recipient, or null when none is set.
"Test recipient"
Time you created the recipient, as an ISO 8601 datetime in UTC.
"2026-03-01T12:00:00Z"
Contact email address, or null when none is set.
"recipient@example.com"
Account holder identification. In Chile, the Chilean tax ID (RUT). Cannot change after creation. Returns null when none is set.
"111111111"
Account holder name, or null when unavailable.
"Test Customer 1"
Account holder category. One of person, company, or unknown.
person, company, unknown "person"
Financial institution that holds the destination account.
Show child attributes
Show child attributes
Time you last updated the recipient, as an ISO 8601 datetime in UTC.
"2026-03-01T12:00:00Z"
Was this page helpful?