Skip to main content

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​

ParameterTypeRequiredDescription
org_idstringYesYour organization ID
holder_idstringYesHolder'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.

FieldTypeDescription
firstNamestringUpdated first name
lastNamestringUpdated last name
emailstringUpdated email (must remain unique)
phonestringUpdated 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.