curl --request POST \
--url https://api.finup.io/backend/cards \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"bin_id": "67c401f9a5b7cde210f44567",
"balance_type": "limit",
"name": "Marketing card"
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
bin_id: '67c401f9a5b7cde210f44567',
balance_type: 'limit',
name: 'Marketing card'
})
};
fetch('https://api.finup.io/backend/cards', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.finup.io/backend/cards"
payload = {
"bin_id": "67c401f9a5b7cde210f44567",
"balance_type": "limit",
"name": "Marketing card"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"result": [
{
"id": "67c48f6fc8614632e0b338fc",
"name": "Marketing card",
"bin_id": "67bcf2abf8e89d31c5f8995e",
"notes": "Q3 campaigns",
"account": "67c401f9a5b7cde210f44567",
"user": "67aa1b2c3d4e5f6789abcdef",
"status": "enabled",
"category": "business",
"currency": "USD",
"masked_PAN": "1234 56•• •••• 5678",
"EXP": "**/**",
"balance": 50,
"deposit": 1000,
"withdraw": 500,
"balance_type": "limit",
"limit_amount": 500,
"limit_period": "thirty_days",
"balance_possibility": true,
"limit_possibility": true,
"auto_deposit": false,
"balance_threshold": 25,
"top_up_amount": 100,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"3ds": true,
"address": "2381 Zanker Rd Ste 110, San Jose, CA, 95131, US",
"PAN": "1234 5678 1234 5678",
"CVV": "123"
}
]
}Issue cards
Issues quantity cards on one BIN. balance_type is required and must be supported by the BIN.
curl --request POST \
--url https://api.finup.io/backend/cards \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"bin_id": "67c401f9a5b7cde210f44567",
"balance_type": "limit",
"name": "Marketing card"
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
bin_id: '67c401f9a5b7cde210f44567',
balance_type: 'limit',
name: 'Marketing card'
})
};
fetch('https://api.finup.io/backend/cards', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.finup.io/backend/cards"
payload = {
"bin_id": "67c401f9a5b7cde210f44567",
"balance_type": "limit",
"name": "Marketing card"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"result": [
{
"id": "67c48f6fc8614632e0b338fc",
"name": "Marketing card",
"bin_id": "67bcf2abf8e89d31c5f8995e",
"notes": "Q3 campaigns",
"account": "67c401f9a5b7cde210f44567",
"user": "67aa1b2c3d4e5f6789abcdef",
"status": "enabled",
"category": "business",
"currency": "USD",
"masked_PAN": "1234 56•• •••• 5678",
"EXP": "**/**",
"balance": 50,
"deposit": 1000,
"withdraw": 500,
"balance_type": "limit",
"limit_amount": 500,
"limit_period": "thirty_days",
"balance_possibility": true,
"limit_possibility": true,
"auto_deposit": false,
"balance_threshold": 25,
"top_up_amount": 100,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"3ds": true,
"address": "2381 Zanker Rd Ste 110, San Jose, CA, 95131, US",
"PAN": "1234 5678 1234 5678",
"CVV": "123"
}
]
}Authorizations
Body
"67c401f9a5b7cde210f44567"
Whether the card runs on a stored balance or a spending limit. The chosen model must be supported by the BIN (see balance_possibility / limit_possibility on GET /bins).
balance, limit "limit"
"Marketing card"
"67fc3d09766d7a2c1fafef99"
"Q3 campaigns"
25
100
Number of cards to issue. Either quantity or the legacy alias amount must be present.
x >= 11
Legacy alias for quantity. Prefer quantity.
x >= 11
Spending limit for balance_type "limit". null = unlimited card, 0 = card cannot spend. Ignored for balance cards.
x <= 1000000500
Reset period of the spending limit. Only for balance_type "limit"; defaults to "all_time" when a limit amount is given without a period. "per_transaction" caps each single operation instead of a rolling window.
one_day, seven_days, thirty_days, all_time, per_transaction "thirty_days"
"WELCOME"
Response
Success
Show child attributes
Show child attributes