Add New Card

Add a new card to the user’s wallet.\n\nAuthentication Required: Public Key or API Key\n- Requires X-Public-Key: <public_key> header OR X-API-Key: <api_key> header\n- Public key identifies the merchant but provides limited access\n- API key provides full access\n\nAdditional Requirements:\n- X-User-Id header required\n- X-Request-Id header required for tracking\n- Request body with card details\n\nUse Case: Add payment method to user’s wallet with automatic tokenization

Authorizations

X-Auth0-Key · string · header · required

Internal use only

Headers

x-request-id · string | null

Unique request identifier for tracing and debugging. Auto-generated if not provided.

x-user-id · string · required

End-user identifier within a customer organization. Required for user-scoped operations.

Body

application/json

Request model for collecting new card information (V2).

card_number · string · required

Card number

Required string length: 12 - 19

card_cvv · string · required

CVV code

card_holder · string · required

Card holder name

Required string length: 1 - 255

card_exp · string · required

Card expiration (MM/YY)

email · string<email> · required

Cardholder email

phone_number · string<phone> · required

Phone number in E.164 format

Examples:

"[phone]"

"[phone]"

"[phone]"

billing_address · string · required

Billing address

Minimum length: 1

zip_code · string · required

ZIP code

last4_digits · string | null

Last 4 digits

city · string | null

City

Minimum length: 1

state · string | null

State/province code

is_default · boolean | null

Set as default payment method

Response

201

application/json

Card added successfully

Response model for card operations (create/update/delete).

status · string · required

Operation status

message · string · required

Human-readable message

card_id · string | null

Affected card ID