---
title: "Order Cards"
method: POST
path: "/cards/order"
---

# Order Cards

`POST /cards/order`

Order Physical Cards

## Request body

- object
  - `debitAccountId` string, required — The debit account `_id`.
  - `customerId` string — The customer `_id`. Required if creating 1 card
  - `brand` 'Verve' | 'AfriGo' | 'MasterCard' | 'Visa', required — The card brand.
  - `currency` 'NGN' | 'USD', required — The currency type.
  - `design` 'SudoBlack' | 'SudoWhite' | '[YourDesignName]' — The name of the card design. Ask Customer support for your own design name.
  - `allocation` integer, required — The number of physical cards to order.
  - `nameOnCards` string[] — Array of names to be personalized on the cards.
  - `expedite` boolean, required — The expedite preference.
  - `shippingMethod` 'NIPOST' | 'DHL', required — The shipping method to use. Might impact card cost. Ask Customer Support for guidance.
  - `shippingAddress` object, required — The cards shipping address.
    - `line1` string, required — Street address line 1
    - `line2` string — Street Address line 2
    - `city` string, required — City
    - `state` string, required — State
    - `postalCode` string, required
    - `country` string, required — Billing country

## Response `201`

Cards ordered successfully.

- object
  - `statusCode` integer — Status code of the response. `200` indicates a successful request.
  - `message` string — Human-readable description of the result.
  - `data` object — Response payload.
    - `batchReference` string — Reference for the card order batch.
    - `allocation` integer — Number of cards in the order.
    - `brand` string — Card scheme/brand (e.g. `Verve`, `MasterCard`).
    - `status` string — Current status of the object.

## Other responses

- `400` — Validation error.
- `401` — Authentication failed — missing or invalid API key.

---

[API](https://skmtc.net/sudo/apis/sudo-sandbox-api.md) · [All operations](https://skmtc.net/sudo/apis/sudo-sandbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sudo/sudo-sandbox-api/versions/52be624fcb53/schema)