v1

latestOpenAPI 3.0.02026-07-267331140.7 KB

Physical Card Order

Create a Physical Card

The last step in the physical card creation process.

Note: To apply a coupon code, use the /api/v1/order/{orderId}/attach-coupon endpoint before creating the card.

Validation Requirements:

User must have completed KYC successfully
User must have a verified phone number
User must have name and address set
User's country must be supported
User must not have reached maximum active cards limit
Safe account should be setup
User must not have existing pending card orders
For paid cards, a valid transaction hash is required

post/api/v1/order/{orderId}/create-card

Path parameters

orderIdstring required

Example:1234

The unique identifier of the card order.

Request body

transactionHashstring

Transaction hash for card payment. Required for paid cards. Must be in hexadecimal format (0x...).

Example request

{
  "pinData": {
    "encryptedKey": "encryptedKey",
    "encryptedPin": "encryptedPin",
    "iv": "iv"
  },
  "transactionHash": "0x1234567890123456789012345678901234567890123456789012345678901234"
}

Response

The card was created successfully

successboolean

cardTokenstring

The token of the created card

Example response

{
  "success": true,
  "cardToken": "1234567890"
}