curl -X POST "{{base_url}}/card/edit-user" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"phone": "254712345678",
"country": "KE",
"state": "Nairobi",
"city": "Nairobi",
"address": "10 Riverside Drive",
"zip_code": "00100",
"id_type": "Passport",
"id_number": "P987654321"
}'
{
"code": 200,
"message": "Card user updated.",
"data": {
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"email": "ada@example.com",
"name": "Ada Lovelace"
}
}
Cards
Edit card user
Update a cardholder’s phone, address, and identity document.
POST
/
card
/
edit-user
curl -X POST "{{base_url}}/card/edit-user" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"phone": "254712345678",
"country": "KE",
"state": "Nairobi",
"city": "Nairobi",
"address": "10 Riverside Drive",
"zip_code": "00100",
"id_type": "Passport",
"id_number": "P987654321"
}'
{
"code": 200,
"message": "Card user updated.",
"data": {
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"email": "ada@example.com",
"name": "Ada Lovelace"
}
}
Updates phone, address, and identity fields for a cardholder that belongs to your partner account.
The response is a short card user:
first_name, last_name, and email cannot be changed here.
string
required
Cardholder id returned by create card user.
string
required
Phone number.
string
required
Country.
string
required
State or region.
string
required
City.
string
required
Street address.
string
required
Postal code.
string
required
National_ID, Passport, or Driving_License.string
required
Government ID number. Must not belong to a different cardholder.
user_id, email, and name.
Errors
| Message | When |
|---|---|
| First validator error | A required field is missing or id_type is invalid |
Card user not found. | user_id is missing for this partner |
Card user can't be edited because a card has not been created. Create a card first. | The cardholder has no issuer profile |
The id number has already been taken. | ID number belongs to another cardholder |
An unexpected error occurred. Please try again. | The update could not be completed |
curl -X POST "{{base_url}}/card/edit-user" \
-H "x-api-key: YOUR_CONSUMER_KEY" \
-H "Content-Type: application/json" \
-d '{
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"phone": "254712345678",
"country": "KE",
"state": "Nairobi",
"city": "Nairobi",
"address": "10 Riverside Drive",
"zip_code": "00100",
"id_type": "Passport",
"id_number": "P987654321"
}'
{
"code": 200,
"message": "Card user updated.",
"data": {
"user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"email": "ada@example.com",
"name": "Ada Lovelace"
}
}