Skip to content

Update OTP Phone Number

Endpoint

PUT/api/v1/merchant/cards/{cardId}/phone/

Used for updating the cardholder's phone number for receiving an SMS OTP during 3DS authentication and digital wallet provisioning.

Path Parameters

Name Type Required Description
cardId string ✅ The unique identifier of the card for which the phone number will be updated.

Request Body

{
  "dialCode": 1,
  "phoneNumber": "1234567890"
}

Body Parameters

Name Type Required Description
dialCode float ✅ The country dial-in code for the cardholder’s phone number. The + sign is not needed.
phoneNumber string ✅ The cardholder’s phone number, including the area code.

Example Request

PUT /api/v1/merchant/cards/{cardId}/phone/
Content-Type: application/json

{
  "dialCode": 44,
  "phoneNumber": "7896543210"
}

Response

{
  "phoneBefore": "+1 9876543210",
  "phoneAfter": "+44 7896543210"
}

Response Codes

Status Code Description
200 OK Cardholder phone number updated successfully.
400 Bad Request Invalid request parameters.
401 Unauthorized Authentication failed.
404 Not Found Card not found.
500 Internal Server Error Server error.