curl -X PUT 'https://api.yativo.com/api/v1/beneficiaries/payment-methods/update/pm-a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: pm-update-001' \
-d '{
"gateway_id": 42,
"currency": "CLP",
"nickname": "Maria Savings Account",
"payment_data": {
"account_number": "98765432",
"bank_code": "014",
"account_type": "savings",
"rut": "12.345.678-9"
}
}'
{
"status": "success",
"data": {
"id": "pm-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"user_id": "usr-001",
"gateway_id": 42,
"currency": "CLP",
"nickname": "Maria Savings Account",
"payment_data": {
"account_number": "98765432",
"bank_code": "014",
"account_type": "savings",
"rut": "12.345.678-9"
},
"beneficiary_id": null,
"created_at": "2026-04-02T10:30:00.000000Z",
"updated_at": "2026-04-02T15:00:00.000000Z"
}
}
Beneficiaries
Update Beneficiary
Update a saved beneficiary’s account details
PUT
/
beneficiaries
/
payment-methods
/
update
/
{id}
curl -X PUT 'https://api.yativo.com/api/v1/beneficiaries/payment-methods/update/pm-a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: pm-update-001' \
-d '{
"gateway_id": 42,
"currency": "CLP",
"nickname": "Maria Savings Account",
"payment_data": {
"account_number": "98765432",
"bank_code": "014",
"account_type": "savings",
"rut": "12.345.678-9"
}
}'
{
"status": "success",
"data": {
"id": "pm-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"user_id": "usr-001",
"gateway_id": 42,
"currency": "CLP",
"nickname": "Maria Savings Account",
"payment_data": {
"account_number": "98765432",
"bank_code": "014",
"account_type": "savings",
"rut": "12.345.678-9"
},
"beneficiary_id": null,
"created_at": "2026-04-02T10:30:00.000000Z",
"updated_at": "2026-04-02T15:00:00.000000Z"
}
}
Update a saved beneficiary. All required fields must be provided. This replaces the whole record.
PUT /v1/beneficiaries/payment-methods/update/{id}
Requires an
Idempotency-Key header.curl -X PUT 'https://api.yativo.com/api/v1/beneficiaries/payment-methods/update/pm-a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: pm-update-001' \
-d '{
"gateway_id": 42,
"currency": "CLP",
"nickname": "Maria Savings Account",
"payment_data": {
"account_number": "98765432",
"bank_code": "014",
"account_type": "savings",
"rut": "12.345.678-9"
}
}'
{
"status": "success",
"data": {
"id": "pm-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"user_id": "usr-001",
"gateway_id": 42,
"currency": "CLP",
"nickname": "Maria Savings Account",
"payment_data": {
"account_number": "98765432",
"bank_code": "014",
"account_type": "savings",
"rut": "12.345.678-9"
},
"beneficiary_id": null,
"created_at": "2026-04-02T10:30:00.000000Z",
"updated_at": "2026-04-02T15:00:00.000000Z"
}
}
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Headers
A unique string per request to ensure idempotent processing.
Path Parameters
The ID of the beneficiary payment method to update.
Body
application/json
The ID of the payout method (gateway).
Currency code for this payment method (e.g. CLP, MXN, BRL).
Updated key/value pairs of account details. Must include all fields required by the selected gateway.
A label to identify this payment method.