Update Card Verification Phone
POST /openapi/v1/cards/{cardId}/3ds-contact/phone
Uses existing OpenAPI signing. cardId is the card identifier returned by card queries, not a full card number or database primary key. Only cards owned by the credential tenant are accessible.
Send application/json. Update one contact at a time. This changes only this card’s verification recipient, not login email, KYC or other cards, and does not send a verification code. Confirm cardholder authorization and ownership before submitting.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
requestNo | string | Yes | 1–64 letters, digits, underscores or hyphens; unique within this tenant and operation family. |
countryCode | string | Yes | + followed by 1–4 digits. |
phone | string | Yes | 6–15 digits, without country code or separators. |
ownershipVerified | boolean | Yes | Must be true: caller attests authorization and ownership verification; this is not platform OTP verification. |
json
{
"requestNo": "contact_phone_001",
"countryCode": "+852",
"phone": "12345678",
"ownershipVerified": true
}Operation fields
For updates these are the fields of data; for queries they are operations[].
| Field | Type | Description |
|---|---|---|
operationNo | string | Platform operation identifier. |
requestNo | string | Caller idempotency key. |
field | string | EMAIL or PHONE. |
targetMasked | string | Masked requested contact. |
status | string | UNKNOWN, ACCEPTED, CONFIRMED, FAILED. |
providerCode | string/null | Safe channel result code, nullable. |
createdAt | string | Creation time. |
updatedAt | string | Update time. |
Status and retries
- The outer
code=200means the platform handled the request, not that the contact is effective. UNKNOWN: submission may still be in flight or its result is uncertain.ACCEPTED: channel accepted the update, effectiveness is not confirmed. Both block other updates to this card.CONFIRMED: the platform verified external evidence that the update took effect.FAILED: definitive rejection or externally verified failure. Either permits a new update.- Same
requestNoand content returns the existing operation; changed content returnsUCARD_REQUEST_CONFLICT. Do not change keys to bypass an unresolved result. Query the existing record to trigger automatic verification. Contact platform support if the result remains unresolved; OpenAPI has no manual resolve endpoint. - Unsupported edits return
UCARD_CONTACT_UNSUPPORTED; pending operations returnUCARD_CONTACT_PENDING; invalid data returnsUCARD_CONTACT_INVALID. These identifiers appear inmsg, not as a replacement for the outer numericcode.
