Getting Started Guides
Create a new Financial Account for a Customer’s existing card account at a financial institution. This could be a credit card, debit card, or prepaid card.
This type of Financial Account is called an “external Financial Account” because it is linked to an account at an external financial institution.
In this guide, you’ll learn how to:
Sandbox Account: Sign up for a RocketKOR sandbox account. When your sandbox account is created, one or more Service Accounts will be created for your Business Account. A Service Account is a non-human user of a Business Account that performs functions (such as creating transactions) via the RocketKOR APIs on behalf of the Business Account.
Authentication: Before you can call the APIs, you must authenticate a Service Account by exchanging the account’s API key and secret for an access token.
Customer Account: Ensure the Business Customer or Individual Customer has an active Customer Account.
Use the Identity Verification solution to verify the Customer Account. For details, see Get Started: Verify a Customer (IDV).
Create an external Financial Account for the Customer’s card account. At a minimum, the request must include the following information:
|
Parameter |
Description |
|---|---|
|
name |
Name for the Financial Account. |
|
accountHolderId |
Customer Account ID. |
|
accountHolderType |
Type of entity referenced by accountHolderId. Value must be CUSTOMER. |
|
subtype |
Type of card (DEBIT, CREDIT, PREPAID). |
|
card |
Details for the Customer’s card. Includes firstName, lastName, cardNumber, expiry, and billingAddress. |
POST /v1/external-cards
{
"name": "Debit Card",
"accountHolderId": "91365a4a-c040-4c37-bb8a-50f46edde48b",
"accountHolderType": "CUSTOMER",
"subtype": "DEBIT",
"card": {
"firstName": "Mark",
"lastName": "Strong",
"cardNumber": "84563876999",
"expiry": "2027-12",
"billingAddress": {
"addressLine1": "625 Queen St",
"city": "Vancouver",
"state": "BC",
"country": "CAN",
"postalCode": "V5K 0A1"
}
}
}
Returns the External Card Financial Account object.
Make a note of the Financial Account id. You’ll need this ID in the next step when you retrieve the Financial Account.
{
"id": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
"businessAccountId": "c937109c-6077-4b4e-8d28-c6768e3546c5",
"name": "Debit Card",
"category": "EXTERNAL",
"type": "CARD",
"subtype": "DEBIT",
"accountHolderId": "8c8c5119-3abd-42e8-8b37-f8eaaa4afacb",
"accountHolderType": "CUSTOMER",
"state": "ACTIVE",
"card": {
"firstName": "Mark",
"lastName": "Strong",
"cardNumber": "84563876999",
"expiry": "2027-12",
"billingAddress": {
"addressLine1": "625 Queen St",
"city": "Vancouver",
"state": "BC",
"country": "CAN",
"postalCode": "V5K 0A1"
}
}
...
}
Retrieve the Financial Account that you created in the previous step.
GET /v1/financial-accounts/{financialAccountId}
In the request, pass the Financial Account id to the financialAccountId parameter.
Returns the External Card Financial Account object.
{
"id": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
"businessAccountId": "c937109c-6077-4b4e-8d28-c6768e3546c5",
"name": "Debit Card",
"category": "EXTERNAL",
"type": "CARD",
"subtype": "DEBIT",
"accountHolderId": "8c8c5119-3abd-42e8-8b37-f8eaaa4afacb",
"accountHolderType": "CUSTOMER",
"state": "ACTIVE",
"card": {
"firstName": "Mark",
"lastName": "Strong",
"cardNumber": "84563876999",
"expiry": "2027-12",
"billingAddress": {
"addressLine1": "625 Queen St",
"city": "Vancouver",
"state": "BC",
"country": "CAN",
"postalCode": "V5K 0A1"
}
}
...
}
The Financial Account can now be used in Push-to-Card transactions. Note that external card Financial Accounts cannot be used for ACH or Wire transactions.
Step into the future of Finance with RocketKOR! Simplify payments, banking, lending, and data analytics using our versatile KOR Platform.
A Rocket Financial Inc. company
@ 2024 RocketKOR, Inc. All rights reserved.
