Update beneficiary
Bearer ds_live_ / ds_test_PUT
/api/v1/merchant/beneficiaries/{id}Changes the label or customer name of a saved beneficiary. To change the number or biller, save a new beneficiary and delete the old one.
Language
curl -X PUT "https://finaldatasub.com/api/v1/merchant/beneficiaries/52" \
-H "Authorization: Bearer ds_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"label": "Mum'\''s DStv"
}'Authentication
Send your secret API key in the header. Authorization: Token … and X-API-Key: … are also accepted.
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer ds_live_YOUR_KEY | Yes |
| Content-Type | application/json | Yes |
| Accept | application/json | Recommended |
Authentication failures (401 UNAUTHORIZED, 403 IP_NOT_ALLOWED / ACCOUNT_SUSPENDED / API_ACCESS_NOT_APPROVED, 429 RATE_LIMITED) are listed in Authentication.
Parameters
Responses
200 OK — Updated · 404 Not Found — Not found
{
"success": true,
"message": "Beneficiary updated.",
"data": {
"id": 52,
"user_id": 1042,
"category": "cable",
"biller_id": 12,
"label": "Mum's DStv",
"customer_ref": "7034567890",
"customer_name": "JOHN DOE",
"last_product_id": null,
"last_amount": null,
"metadata": null,
"last_used_at": null,
"created_at": "2026-10-05T10:50:00.000000Z",
"updated_at": "2026-10-06T09:12:00.000000Z"
}
}Errors
Errors specific to this endpoint, in addition to the authentication and validation errors common to every request.
| Code | HTTP | When |
|---|---|---|
| — | 404 | No beneficiary with this id on your account ({success: false, message} body). |
Notes
- Only
labelandcustomer_namecan be changed; other fields are ignored.