Skip to main content
POST
/
cards
/
issue
Issue a new card
curl --request POST \
  --url https://business.bfinance.app/external/api/cards/issue \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "typeId": "603e12345e1234567890abcd",
  "initialBalance": 1000,
  "firstName": "John",
  "lastName": "Doe",
  "externalId": "1234567890",
  "label": "Travel Card",
  "customerId": "603e12345e1234567890abcd",
  "configuration": {
    "displayName": "Travel Card",
    "address": {
      "line1": "123 Main St",
      "line2": "Apt 4B",
      "city": "New York",
      "region": "NY",
      "postalCode": "10001",
      "countryCode": "USA"
    }
  }
}
'
{
  "status": "success",
  "data": {
    "card": {
      "id": "<string>",
      "cardNumber": "<string>",
      "cardExpire": "<string>",
      "cardCVC": "<string>",
      "cardBalance": 123,
      "currency": "<string>",
      "maskedCardNumber": "<string>",
      "brand": "<string>",
      "label": "<string>"
    }
  }
}

Authorizations

Authorization
string
header
required

JWT authentication token

Body

application/json
typeId
string
required

The ID of card type

Example:

"603e12345e1234567890abcd"

initialBalance
integer
required

The initial balance for the card

Example:

1000

firstName
string
required

First name of the cardholder

Example:

"John"

lastName
string
required

Last name of the cardholder

Example:

"Doe"

externalId
string
required

External ID (optional)

Example:

"1234567890"

label
string

A label for the card (optional)

Example:

"Travel Card"

customerId
string

Customer ID (optional, required for specific card types)

Example:

"603e12345e1234567890abcd"

configuration
object

Configuration details for the card (optional)

Response

Successfully issued a card

status
string
Example:

"success"

data
object