curl --request PATCH \
--url https://api.fintoc.com/v2/recipients/{id} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"alias": "Updated recipient"
}
'{
"id": "rcp_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"account_number": "000000000000000000",
"account_type": "clabe",
"alias": "Updated 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"
}
}Update a recipient
Updates recipient details in Chile and Mexico. You can update account_type only in Chile. The account_number, institution_id, and holder_id fields cannot change. Omitted fields keep their current values. Send null or a blank string to clear alias or email. Returns the updated recipient.
curl --request PATCH \
--url https://api.fintoc.com/v2/recipients/{id} \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"alias": "Updated recipient"
}
'{
"id": "rcp_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"account_number": "000000000000000000",
"account_type": "clabe",
"alias": "Updated 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?