Skip to main content
POST
/
customers
/
{customer_id}
/
cards
Create a card
curl --request POST \
  --url https://commerce1.on-hellgate.dev/customers/{customer_id}/cards \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "cardholder_name": "<string>",
  "expiration_month": 123,
  "expiration_year": 123,
  "masked_card_number": "<string>",
  "provider": "<string>",
  "token": "<string>"
}
'
{
  "cardholder_name": "<string>",
  "expiration_month": 123,
  "expiration_year": 123,
  "masked_card_number": "<string>",
  "provider": "<string>",
  "status": "<string>",
  "token": "<string>"
}

Authorizations

X-API-Key
string
header
required

Headers

X-Account-ID
string

Identifies the account. Required when authenticating via mTLS — omit when using an API key (account is inferred from the key).

Path Parameters

customer_id
string
required

Customer ID

Body

application/json

Body

cardholder_name
string
required
expiration_month
integer
required
expiration_year
integer
required
masked_card_number
string
required
provider
string
required
token
string
required

Response

Success

cardholder_name
string
expiration_month
integer
expiration_year
integer
masked_card_number
string
provider
string
status
string
token
string