Issue

Request a card. It cannot spend until the provider issues it. At least one limit is required. A card with none is a standing instruction to move a business's money without a ceiling, and the absence of a decision is not the same as deciding to allow everything.

Request a card. It cannot spend until the provider issues it.

At least one limit is required. A card with none is a standing instruction to move a business's money without a ceiling, and the absence of a decision is not the same as deciding to allow everything.

Authorization

OAuth2PasswordBearer

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

A card to issue. IN-302.

Inherits the three limit fields above, so a card can be issued with its ceilings already set rather than issued open and tightened afterwards.

per_transaction_minor?|

Minor units. The most a single authorisation may be — 50000 is 500.00. Anything above it is declined at the network, not queued.

Example50000

daily_minor?|

Minor units. Total authorised in a rolling 24 hours.

Example200000

monthly_minor?|

Minor units. Total authorised in a calendar month, UTC.

Example2000000

holder_user_id*Holder User Id

The member the card belongs to. They must already be a member of this business — a card cannot be issued to somebody who could not sign in and see it.

Formatuuid

Example"3f9a1b2c-8d7e-4f60-9a1b-2c3d4e5f6a7b"

currency*Currency

ISO 4217, upper-cased for you. Fixed once issued; spending in another currency is converted by the network at their rate.

Length3 <= length <= 3

Example"USD"

label?|

Your name for the card, shown wherever cards are listed. Worth setting — the alternative is telling four cards apart by their last four digits.

Example"Ops — subscriptions"

Response Body

`application/json`

curl -X POST "https://example.com/api/b/v1/cards" \  -H "Content-Type: application/json" \  -d '{    "holder_user_id": "3f9a1b2c-8d7e-4f60-9a1b-2c3d4e5f6a7b",    "currency": "USD"  }'

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "label": "string",  "holder_user_id": "0945901a-0f71-46d3-9812-de7afb578bb4",  "currency": "string",  "status": "string",  "last_four": "string",  "expiry": "string",  "per_transaction_minor": 0,  "daily_minor": 0,  "monthly_minor": 0,  "allowed_categories": [    "string"  ],  "blocked_categories": [    "string"  ],  "allowed_countries": [    "string"  ],  "blocked_countries": [    "string"  ],  "frozen_reason": "string",  "created_at": "2019-08-24T14:15:22Z"}

Authorization

Cookie Parameters

Request Body

Response Body

201application/json

422application/json

`application/json`

`application/json`