Change 3DS phone number
POST/api/partner/cards/:id/change-3ds-phone
Updates the phone number used to deliver the 3-D Secure OTP.
Which phone number is used for 3-D Secure? The cardholder record carries two phone fields:
authPhoneNumber— the dedicated phone for 3-D Secure OTP deliveryphoneNumber— the general contact phone
At 3-D Secure time we use authPhoneNumber if it is set; if it is
empty, we fall back to phoneNumber. The value you POST in
newPhoneNumber on this endpoint becomes the new authPhoneNumber.
Response shape. The success path returns exactly
{ "success": true }. The warnings field is only present
when a downstream sync silently failed — it is omitted entirely
on the all-clean path, never returned as an empty array.
Request
Responses
- 200
- 400
- 401
- 403
3DS phone updated
Bad request — missing or invalid fields
Unauthorized — missing or invalid JWT
Forbidden — resource not owned by the calling partner