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"
}
}Authorizations
Path Parameters
Unique identifier of the recipient.
Body
Label you assign to the recipient. Send null or a blank string to clear it.
"Test recipient"
Account holder name. Up to 40 characters.
"Test Customer 1"
Account holder category. One of person or company.
person, company "person"
Destination account type. Chile only. One of checking_account, sight_account, or savings_account.
checking_account, sight_account, savings_account "checking_account"
Contact email address in name@example.com format. Up to 200 characters. Send null or a blank string to clear it.
"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?