Business Accounts

Recipients

Financial Accounts

Payment Reasons

Transactions

Notes

Create a Recipient Card Account

Create a card Financial Account for a Recipient Account. You can create card Financial Accounts for Mastercard and Visa debit cards and for eligible Discover cards.

Endpoint

POST /recipients/{recipientId}/financial-accounts/cards

Authorization Header

Authorization: Bearer <access_token>

where <access_token> is your RocketKOR access token.

Path Parameters

recipientId REQUIRED

string (UUID)

Recipient Account ID. The Financial Account will be created for this Recipient Account.

Request Body

name

string, max length: 100, min length: 1

Name for the Financial Account.

defaultFlag

boolean

default: false

Whether this the default Financial Account for transactions. If set to true, defaultFlag will be set to false for the recipient’s previous default Financial Account.

currency

string, max length: 3, min length: 3

default: USD

Currency of the Financial Account. Must be an ISO 4217 alpha 3-character currency code. RocketKOR supports USD and CAD currencies.

card REQUIRED

object

Details for the card attached to the Financial Account.

firstName

string, max length: 40, min length: 1

Recipient’s first name as it appears on the card.

middleName

string, max length: 40, min length: 1

Recipient’s middle name as it appears on the card.

lastName

string, max length: 40, min length: 1

Recipient’s last name as it appears on the card.

type REQUIRED

string enum, values: DEBIT

Type of card.

expiry REQUIRED

string, required format: YYYY-MM

Expiry date for the card.

billingAddress REQUIRED

object

Billing address for the card.

addressLine1 REQUIRED

string, max length: 50, min length: 1

Address line 1.

addressLine2

string, max length: 50, min length: 1

Address line 2.

addressLine3

string, max length: 50, min length: 1

Address line 3.

city REQUIRED

string, max length: 25, min length: 1

City.

state CONDITIONAL

string, max length: 3, min length: 2

State, province, or territory. Required if country is USD or CA. Must be an ISO 3166-2 uppercase alpha 2-character or 3-character country subdivision code. For example, Missouri is MO.

country

string, max length: 3, min length: 3

Country. Must be an ISO 3166-1 uppercase alpha 3-character country code. For example, the United States is USA.

postalCode REQUIRED

string, max length: 10, min length: 1

ZIP code or postal code. For US addresses, must be a valid value of 5 digits (example: 63368) or 5 digits-4 digits (example: 63368-5555). Can be alphanumeric for other countries.

cardNumber REQUIRED

string, max length: 19, min length: 11, pattern: [\d]{11,19}

Card number.

Returns

Returns the Recipient Financial Account details, including a unique ID for the account. For details, see the Card Financial Account object.

SAMPLE REQUEST

				
					{
  "name": "Debit Card",
  "defaultFlag": true,
  "currency": "USD",
  "card": {
    "firstName": "Mark",
    "middleName": "David",
    "lastName": "Strong",
    "type": "DEBIT",
    "expiry": "2027-12",
    "billingAddress": {
      "addressLine1": "625 Queen St",
      "addressLine2": "",
      "addressLine3": "",
      "city": "Vancouver",
      "state": "BC",
      "country": "Canada",
      "postalCode": "V5K 0A1"
    },
    "cardNumber": "84563876999"
  }
}

SAMPLE RESPONSE

				
					{
  "id": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
  "businessAccountId": "c937109c-6077-4b4e-8d28-c6768e3546c5",
  "recipientId": "402edc38-a81e-4a38-a88c-1598d162bdbd",
  "name": "Debit Card",
  "defaultFlag": true,
  "currency": "USD",
  "state": "ACTIVE",
  "createdAt": "2021-07-08T21:10:51.610Z",
  "updatedAt": "2021-07-08T21:10:51.610Z",
  "accountType": "EXTERNAL",
  "card": {
    "firstName": "Mark",
    "middleName": "David",
    "lastName": "Strong",
    "type": "DEBIT",
    "expiry": "2027-12",
    "billingAddress": {
      "addressLine1": "625 Queen St",
      "addressLine2": "",
      "addressLine3": "",
      "city": "Vancouver",
      "state": "BC",
      "country": "Canada",
      "postalCode": "V5K 0A1"
    },
    "cardNumber": "84563876999"
  }
}