Skip to main content
POST
/
cards
/
order
Order Cards
curl --request POST \
  --url https://api.sandbox.sudo.cards/cards/order \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "debitAccountId": "<string>",
  "brand": "Verve",
  "currency": "NGN",
  "allocation": 1,
  "expedite": false,
  "shippingMethod": "NIPOST",
  "shippingAddress": {
    "line1": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postalCode": "<string>",
    "country": "<string>",
    "line2": "<string>"
  },
  "customerId": "<string>",
  "design": "SudoBlack",
  "nameOnCards": [
    "<string>"
  ]
}
'
"{}"

Authorizations

​
Authorization
string
header
default:{{APIKey}}
required

Body

application/json
​
debitAccountId
string
required

The debit account _id.

​
brand
enum<string>
required

The card brand.

Available options:
Verve,
AfriGo,
MasterCard,
Visa
​
currency
enum<string>
default:NGN
required

The currency type.

Available options:
NGN,
USD
​
allocation
integer<int32>
default:1
required

The number of physical cards to order.

​
expedite
boolean
default:false
required

The expedite preference.

​
shippingMethod
enum<string>
default:NIPOST
required

The shipping method to use. Might impact card cost. Ask Customer Support for guidance.

Available options:
NIPOST,
DHL
​
shippingAddress
object
required

The cards shipping address.

​
customerId
string

The customer _id. Required if creating 1 card

​
design
enum<string>
default:SudoBlack

The name of the card design. Ask Customer support for your own design name.

Available options:
SudoBlack,
SudoWhite,
[YourDesignName]
​
nameOnCards
string[]

Array of names to be personalized on the cards.

Response

200

The response is of type object.