Creating a business card

Introduction

After you create a Business and it has passed KYB verification, you can use the cards API to create a business card. This creates a card and simultaneously creates an associated card account. ▶ Run in Postman

A business card and its card account are closely coupled but logically distinct, the difference being what is managed. The card resource contains information about the actual physical or virtual card, while the card account resource stores broader account information, such as what bank accounts are connected to the card.

The card type is determined by the program_id which is provided by Bond Studio. For details, see Card program ID. There are three card types:

  • Virtual
  • Physical
  • Dual

Upon creation, your customer can immediately use the virtual card. If they've been issued with a physical card, they can only use it once it's been activated. See activating a physical card.

Creating a business card and card account

To create a business card, use the POST /cards operation and provide the parameters as shown in the table below.

Parameter

Type

Description

business_id
required

String

UUID that identifies the business generated when you create a business.

program_id
required

String

UUID that represents the card program offered to customers by your brand in partnership with a bank.

credit_limit

String

New credit limit for the card. Decimal format with two decimal places, for example 3000.00.

card_design_id

String

The visual design of card in integer format.
Please contact Bond support for information regarding creating card designs.

An example of a request to create a business card is shown below.

curl --request POST \
     --url https://sandbox.bond.tech/api/v0/cards \
     --header 'Authorization: YOUR-AUTHORIZATION' \
     --header 'Content-Type: application/json' \
     --header 'Identity: YOUR-IDENTITY' \
     --data '
{
     "business_id": "6f0e7dcb-6073-42df-bf02-ce71bd5fac3b",
     "program_id": "2742ff6a-7455-4066-8b45-ae12d3acca34",
     "credit_limit": "3000.00",
     "card_design_id": "5"
}
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://sandbox.bond.tech/api/v0/cards")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request["Identity"] = 'YOUR-IDENTITY'
request["Authorization"] = 'YOUR-AUTHORIZATION'
request.body = "{\"business_id\":\"6f0e7dcb-6073-42df-bf02-ce71bd5fac3b\",\"program_id\":\"2742ff6a-7455-4066-8b45-ae12d3acca34\",\"credit_limit\":\"3000.00\",\"card_design_id\":\"5\"}"

response = http.request(request)
puts response.read_body
const options = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Identity: 'YOUR-IDENTITY',
    Authorization: 'YOUR-AUTHORIZATION'
  },
  body: JSON.stringify({
    business_id: '6f0e7dcb-6073-42df-bf02-ce71bd5fac3b',
    program_id: '2742ff6a-7455-4066-8b45-ae12d3acca34',
    credit_limit: '3000.00',
    card_design_id: '5'
  })
};

fetch('https://sandbox.bond.tech/api/v0/cards', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
import requests

url = "https://sandbox.bond.tech/api/v0/cards"

payload = {
    "business_id": "6f0e7dcb-6073-42df-bf02-ce71bd5fac3b",
    "program_id": "2742ff6a-7455-4066-8b45-ae12d3acca34",
    "credit_limit": "3000.00",
    "card_design_id": "5"
}
headers = {
    "Content-Type": "application/json",
    "Identity": "YOUR-IDENTITY",
    "Authorization": "YOUR-AUTHORIZATION"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)
var client = new RestClient("https://sandbox.bond.tech/api/v0/cards");
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Identity", "YOUR-IDENTITY");
request.AddHeader("Authorization", "YOUR-AUTHORIZATION");
request.AddParameter("application/json", "{\"business_id\":\"6f0e7dcb-6073-42df-bf02-ce71bd5fac3b\",\"program_id\":\"2742ff6a-7455-4066-8b45-ae12d3acca34\",\"credit_limit\":\"3000.00\",\"card_design_id\":\"5\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"business_id\":\"6f0e7dcb-6073-42df-bf02-ce71bd5fac3b\",\"program_id\":\"2742ff6a-7455-4066-8b45-ae12d3acca34\",\"credit_limit\":\"3000.00\",\"card_design_id\":\"5\"}");
Request request = new Request.Builder()
  .url("https://sandbox.bond.tech/api/v0/cards")
  .post(body)
  .addHeader("Content-Type", "application/json")
  .addHeader("Identity", "YOUR-IDENTITY")
  .addHeader("Authorization", "YOUR-AUTHORIZATION")
  .build();

Response response = client.newCall(request).execute();

An example of a response to a successful request to create a business card is shown below.

{
    "card_id": "2742ff6a-7455-4066-8b45-ae12d3acca34",
    "last_four": "6169",
    "status": "Active",
    "card_account_id": "48aef94d-8473-47c8-943f-d3ac1745d8fa",
    "pseudo_dda":  "1010101010101010",
    "business_id": "094cd49b-6412-429f-a396-314097a6c3b9",
    "sponsor_bank_routing_number": "101011011",
    "card_design_id": "5"
}

For a complete specification and interactive examples, see Creating a business card in the Bond API Reference.

For a complete specification and interactive examples of changing a card's limit, see Updating a card in the Bond API Reference.


Did this page help you?