Update Holder
Updates a card holder's information. This is an async operation.
Endpoint​
PATCH /api/v2/organizations/{org_id}/holders/{holder_id}
Path Parameters​
| Parameter | Type | Required | Description |
|---|---|---|---|
org_id | string | Yes | Your organization ID |
holder_id | string | Yes | Holder's cardOwnerId |
Request Body​
{
"firstName": "Jane",
"lastName": "Smith",
"email": "jane.smith@example.com",
"phone": "+1-202-555-0199"
}
Fields​
All fields are optional — send only the fields you want to update.
| Field | Type | Description |
|---|---|---|
firstName | string | Updated first name |
lastName | string | Updated last name |
email | string | Updated email (must remain unique) |
phone | string | Updated phone number (must remain unique) |
Request​
curl -X PATCH "https://api.4pay.cc/api/v2/organizations/{org_id}/holders/{holder_id}" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"firstName": "Jane",
"lastName": "Smith",
"email": "jane.smith@example.com"
}'
Response​
204 No Content
Verify the update via Get Holder Details.