Design / Financial Account Use Cases / Recipient / Create a Recipient Financial Account
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).
Create a Recipient Account for the business or individual.
Send a request to the following endpoint:
POST /v1/recipients/{recipientId}/financial-accounts/cards
Send a request to the following endpoint:
POST /v1/recipients/{recipientId}/financial-accounts/bank-accounts
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"
}
}
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"
}
}
© 2022 Rocket Financial. All rights reserved. RocketFNCL, RocketKOR, RocketBNK are trade names of Rocket Financial Inc.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL
© 2023 by Rocket Financial Inc. All rights reserved.