v5

latestOpenAPI 3.1.02026-07-262421791.5 MB
card

Update phone number

{% admonition type="warning" %} This endpoint is deprecated for partners onboarded after 1/3/2025. For new and existing partners, your clientId will need to be approved by our support team to make the phoneNumber optional in the create card order endpoint. See 3DS for more information. {% /admonition %}

Updates the phone number of a card. The new phone number must be a valid phone number.

put/v3/spend/profiles/{profileId}/cards/{cardToken}/phone-number

Path parameters

profileIdinteger required

Your profile ID.

cardTokenstring required

The card token.

Headers

X-External-Correlation-Idstring uuid

Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. Learn more.

Request body

phoneNumberstring required

Must be a valid phone number prefixed with + and country code.

Example request

{
  "phoneNumber": "+6588888888"
}

Response

Updated card phone number details.

tokenstring

The card token that you are modifying.

profileIdinteger

The profile ID that the card is linked to.

phoneNumberstring

The new phone number associated with the card.

Example response

{
  "token": "12345-12345-12345-12345",
  "profileId": 30000000,
  "phoneNumber": "+6588888888"
}