Issue Card

POST

https://api-sandbox.coinflow.cash/api/merchant/company-cards/cards

POST

/api/merchant/company-cards/cards

$ curl -X POST https://api-sandbox.coinflow.cash/api/merchant/company-cards/cards \
>      -H "Authorization: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "assignedMerchantUserEmail": "string",
>   "type": "virtual"
> }'

200Successful

1 {
2   "_id": "string",
3   "merchantId": "string",
4   "rainCompanyId": "string",
5   "rainUserId": "string",
6   "assignedMerchantUserEmail": "string",
7   "rainCardId": "string",
8   "type": "virtual",
9   "status": "notActivated",
10   "last4": "string",
11   "expirationMonth": "string",
12   "expirationYear": "string",
13   "btToken": "string",
14   "issuedAt": "2024-01-15T09:30:00Z",
15   "lastSyncedAt": "2024-01-15T09:30:00Z",
16   "createdAt": "2024-01-15T09:30:00Z",
17   "updatedAt": "2024-01-15T09:30:00Z",
18   "limit": {
19     "amount": 1.1,
20     "frequency": "per24HourPeriod"
21   },
22   "replacedFromCardId": "string",
23   "termsAcceptedAt": "2024-01-15T09:30:00Z"
24 }

Issue a card for a cardholder. Lazy-provisions the per-user contract on first call. Physical cards rejected until enabled by env flag. Body includes rainUserId so the same route handles every cardholder.

Authentication

Authorizationstring

The API key of the merchant - see https://docs.coinflow.cash/api-reference/api-reference/authentication/get-session-key

Request

This endpoint expects an object.

assignedMerchantUserEmailstringRequired

typeenumRequired

limitobjectOptional

billingobjectOptional

shippingobjectOptional

firstNamestringOptional

lastNamestringOptional

Response

_idstring

merchantIdstring

rainCompanyIdstring

rainUserIdstring

assignedMerchantUserEmailstring

rainCardIdstring

typeenum

statusenum

last4string

expirationMonthstring

expirationYearstring

btTokenstring

issuedAtdatetime

lastSyncedAtdatetime

createdAtdatetime

updatedAtdatetime

limitobject

replacedFromCardIdstring

termsAcceptedAtdatetime