curl --request PATCH \
--url https://api-sandbox.y.uno/v1/recipients/{recipient_id} \
--header 'Content-Type: application/json' \
--header 'private-secret-key: <api-key>' \
--header 'public-api-key: <api-key>' \
--data '
{
"email": "newemail@example.com",
"phone": {
"country_code": "57",
"number": "9876543210"
}
}
'{
"id": "9104911d-5df9-429e-8488-ad41abea1a4b",
"account_id": "9104911d-5df9-429e-8488-ad41abea1a4b",
"merchant_recipient_id": "AAAA01",
"national_entity": "INDIVIDUAL",
"first_name": "John",
"last_name": "Doe",
"email": "newemail@example.com",
"country": "CO",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T11:45:00Z"
}{
"code": "INVALID_REQUEST",
"messages": [
"Invalid request format"
]
}{
"code": "INVALID_CREDENTIALS",
"messages": [
"Invalid credentials"
]
}{
"code": "AUTHORIZATION_REQUIRED",
"messages": [
"The merchant has no authorization to use this API."
]
}Update Recipient
curl --request PATCH \
--url https://api-sandbox.y.uno/v1/recipients/{recipient_id} \
--header 'Content-Type: application/json' \
--header 'private-secret-key: <api-key>' \
--header 'public-api-key: <api-key>' \
--data '
{
"email": "newemail@example.com",
"phone": {
"country_code": "57",
"number": "9876543210"
}
}
'{
"id": "9104911d-5df9-429e-8488-ad41abea1a4b",
"account_id": "9104911d-5df9-429e-8488-ad41abea1a4b",
"merchant_recipient_id": "AAAA01",
"national_entity": "INDIVIDUAL",
"first_name": "John",
"last_name": "Doe",
"email": "newemail@example.com",
"country": "CO",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T11:45:00Z"
}{
"code": "INVALID_REQUEST",
"messages": [
"Invalid request format"
]
}{
"code": "INVALID_CREDENTIALS",
"messages": [
"Invalid credentials"
]
}{
"code": "AUTHORIZATION_REQUIRED",
"messages": [
"The merchant has no authorization to use this API."
]
}Authorizations
Path Parameters
The unique identifier of the recipient
Body
Unique identifier of the recipient defined by the merchant (MAX 255; MIN 1).
Beneficiary's name. (MAX 80; MIN 1).
Beneficiary's last name. (MAX 80; MIN 1).
The Beneficiary's date of birth in the YYYY-MM-DD format (MAX 10; MIN 10).
The Beneficiary's type of organization. GOVERNMENTAL, PUBLIC, NON_PROFIT, PRIVATE
GOVERNMENTAL, PUBLIC, NON_PROFIT, PRIVATE The seller's website URL (MAX 255; MIN 3).
The seller's industry (MAX 235; MIN 1). For more information access the Industry category reference page.
MCC - The merchant category code (MAX 235; MIN 1).
The Beneficiary's email (MAX 255; MIN 3).
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Array of documentation objects
Show child attributes
Show child attributes
Array of onboarding objects for different payment providers
Show child attributes
Show child attributes
Rules for automatic split calculation at the recipient level.
Show child attributes
Show child attributes
Response
Recipient updated successfully
The unique identifier of the recipient.
"3aaa4d82-11e8-48ce-8ef5-04eee3a10802"
The account identifier associated with this recipient.
"fe14c7c6-c75e-43b7-bdbe-4c87ad52c482"
Unique identifier of the recipient defined by the merchant.
"MERCHANT_182acf1d-faeb-4ff0-94cd-7fab11b282f6"
Beneficiary's national entity type.
"INDIVIDUAL"
Beneficiary's type of organization.
"PRIVATE"
Beneficiary's name.
"Juan"
Beneficiary's last name.
"Perez"
Beneficiary's legal name.
null
The Beneficiary's email.
"juan.perez@example.com"
Beneficiary's date of birth.
"1990-01-15"
The Beneficiary's country.
"CO"
The seller's website URL.
"https://juanperez.com"
The seller's industry.
"Technology"
The merchant category code (MCC) (MAX 235; MIN 1).
"5734"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Rules for automatic split calculation at the recipient level.
Show child attributes
Show child attributes
Recipient creation date (ISO 8601 MAX 27; MIN 27).
"2025-08-27T15:41:19.497413Z"
Last Recipient updated date (ISO 8601 MAX 27; MIN 27).
"2025-08-27T15:41:19.497425Z"
Was this page helpful?