Design / Financial Account Use Cases / Recipient / Create a Recipient Financial Account

Create a Recipient Financial Account

Overview

In this use case, we’ll walk through creating a new bank account or card Recipient Financial Account. You can create card Recipient Financial Accounts for Mastercard and Visa debit cards and for eligible Discover cards.

A Recipient Financial Account contains details about the card (number, expiry date, billing address, and so on) or bank account (account number, routing number, and so on). When creating a new Recipient Financial Account, you must link it to an existing Recipient Account. The Recipient Account contains the recipient’s profile information (name, contact information, date of birth, and so on).

Prerequisites

Create a Recipient Account for the business or individual.

API Operations

Create a Recipient Card Account

Create a Recipient Bank Account

Steps: Recipient Card Account

Send a request to the following endpoint:

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

Include an Authorization header with your RocketKOR access token as a Bearer Token.
Use {recipientId} to specify the Recipient Account ID. The Financial Account will be created for this Recipient Account.
Include details about the card in the request body. For a list of required fields, see the API Reference.

Steps: Recipient Bank Account

Send a request to the following endpoint:

POST /v1/recipients/{recipientId}/financial-accounts/bank-accounts

Include an Authorization header with your RocketKOR access token as a Bearer Token.
Use {recipientId} to specify the Recipient Account ID. The Financial Account will be created for this Recipient Account.
Include details about the bank account in the request body. For a list of required fields, see the API Reference.

Sample Request

The following request would create a new debit card Recipient Financial Account.

				
					{
  "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

If the Recipient Financial Account creation is successful, a unique ID is returned for the account. Details about the account creation and the card or bank account are also returned. For details, see the Card Financial Account object and the Bank Financial Account object.

The following example shows the response for the successful creation of a debit card Recipient Financial Account.

				
					{
  "id": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
  "businessAccountId": "c937109c-6077-4b4e-8d28-c6768e3546c5",
  "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",
  "accountHolderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "accountHolderType": "RECIPIENT",
  "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"
  }
}