Create a card product

POST/v1/card-products

Requires an API client bearer token.

Creates a card product under the given programme. Requires an Idempotency-Key header. Emits card_product.created.

Parameters

Header parameters

Name	Required	Description
Idempotency-Key	required	Client-chosen. An identical retry with the same key returns the stored response; reusing the key with a different payload returns 409.

Request body

programme_idstring (uuid)required

namestringrequired

network"visa" | "mastercard"required

currencystringrequired

form_factor"virtual" | "physical"required

iinstringrequired

control_defaultsarray of one of

+ show properties

One of

mcc_allow

kind"mcc_allow"required

valuesarray of stringrequired

mcc_deny

kind"mcc_deny"required

valuesarray of stringrequired

country_allow

kind"country_allow"required

valuesarray of stringrequired

country_deny

kind"country_deny"required

valuesarray of stringrequired

channel_allow

kind"channel_allow"required

valuesarray of stringrequired

channel_deny

kind"channel_deny"required

valuesarray of stringrequired

per_txn_cap

kind"per_txn_cap"required

amountstringrequired

per_day_cap

kind"per_day_cap"required

countintegerrequired

per_day_amount_cap

kind"per_day_amount_cap"required

amountstringrequired

Example

curl -X POST https://api.rigid.fi/v1/card-products \
  -H "Authorization: Bearer $RIGID_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "programme_id": "uuid",
  "name": "string",
  "network": "visa",
  "currency": "string",
  "form_factor": "virtual",
  "iin": "string"
}'

Responses

201

Created card product.

programme_idstring (uuid)required

namestringrequired

network"visa" | "mastercard"required

currencystringrequired

form_factor"virtual" | "physical"required

iinstringrequired

control_defaultsarray of one ofrequired

+ show properties

One of

mcc_allow

kind"mcc_allow"required

valuesarray of stringrequired

mcc_deny

kind"mcc_deny"required

valuesarray of stringrequired

country_allow

kind"country_allow"required

valuesarray of stringrequired

country_deny

kind"country_deny"required

valuesarray of stringrequired

channel_allow

kind"channel_allow"required

valuesarray of stringrequired

channel_deny

kind"channel_deny"required

valuesarray of stringrequired

per_txn_cap

kind"per_txn_cap"required

amountstringrequired

per_day_cap

kind"per_day_cap"required

countintegerrequired

per_day_amount_cap

kind"per_day_amount_cap"required

amountstringrequired

idstring (uuid)required

status"active" | "retired"required

created_atstringrequired

400

Validation error

typestringrequired

titlestringrequired

statusintegerrequired

detailstring

instancestring

401

Authentication required

typestringrequired

titlestringrequired

statusintegerrequired

detailstring

instancestring

403

Forbidden

typestringrequired

titlestringrequired

statusintegerrequired

detailstring

instancestring

409

Idempotency-Key reused with a different payload

typestringrequired

titlestringrequired

statusintegerrequired

detailstring

instancestring

500

Internal server error

typestringrequired

titlestringrequired

statusintegerrequired

detailstring

instancestring