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"
}
}Body
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.
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"
Was this page helpful?