# Create virtual or physical card

**POST /payment/create-card**

Create a new payment card (virtual or physical) linked to an account.
Supports various card types and configurations.



## Servers
- Production API: https://pay-api.aiic.nz/v1 (Production API)
- Staging API: https://pay-api-staging.aiic.nz/v1 (Staging API)
- Development API: https://pay-api-dev.aiic.nz/v1 (Development API)


## Authentication methods
- Api key auth


## Parameters



### Body: application/json (object)

- **data** (object)
  The actual request data to be processed
- **signature** (string)
  ed25519 signature of the data, signed with user's private key
- **publicKey** (string)
  User's derived public key for signature verification
- **timestamp** (integer)
  Unix timestamp when the request was created (milliseconds)
- **nonce** (string)
  Unique nonce to prevent replay attacks


## Responses
### 201
Card created successfully

#### Body: application/json (object)
- **success** (boolean)

- **cardId** (string)

- **cardNumber** (string)
  Masked card number (for virtual cards, full number)
- **expiryDate** (string(date))
  Card expiry date
- **status** (string)

- **cardType** (string)

- **estimatedDelivery** (string(date))
  Estimated delivery date for physical cards

### 400
Invalid request parameters

### 401
Authentication failed

### 403
Insufficient permissions

### 429
Rate limit exceeded

### 500
Internal server error


[Powered by Bump.sh](https://bump.sh)