GET STARTED

RECIPIENT

FINANCIAL ACCOUNT

PAYMENT REASON

TRANSACTION

NOTE

Create a Transaction

A transaction requires two Financial Accounts: a debit account and a credit account. These accounts must belong to the Business Account associated with the API key included in the request.

Debit Financial Account
The funds will be taken from this account. The debit account can be a Business Financial Account or a Recipient Financial Account.

Credit Financial Account
The funds will be disbursed to this account. The credit account can be a Business Financial Account or a Recipient Financial Account.

Endpoint

POST/api/external/v1/transactions

Authorization Header

Basic Auth  REQUIRED

username is your API key ID and password is your API key secret.

Request Body

 

debitFinancialAccountId  REQUIRED

string (UUID)

ID for the Financial Account used as the funding account (source of the disbursed funds).

 

creditFinancialAccountId  REQUIRED

string (UUID)

ID for the Financial Account used as the deposit account (receiver of the disbursed funds).

 

paymentReasonId  REQUIRED

string (UUID)

Payment reason ID for the transaction. Use the Payment Reasons API to retrieve a list of available IDs and their corresponding descriptions.

 

amount  REQUIRED

number, minimum value: 0

Amount to be disbursed from the debit account to the credit account. Must be a positive number.

 

provider  REQUIRED

string enum, values: ACH, MC_SEND

Provider facilitating the transaction.

 

currency  REQUIRED

string

Type of currency used for the transaction. RocketKOR currently supports USD and CAD currency.

 

countryCode  REQUIRED

string, max length: 3, min length: 2

3-digit country code for the transaction country of origin.

 

requestedSendDate

string (date-time), required format: yyyy-MM-dd’T’HH:mm:ss.SSSz

Reserved for future use.

 

receiverId  REQUIRED

string (UUID)

ID of the receiver of the disbursed funds. This could be a Business Account or Recipient Account.

 

receiverType  REQUIRED

string enum, values: BUSINESS_ACCOUNT, RECIPIENT

Type of receiver for the ID specified in receiverId.

Returns

 

Returns the transaction details, including a unique ID for the transaction. The request body and the following fields are returned.

 

id

string (UUID)

Unique ID for the transaction in the RocketKOR system.

 

createdAt

string (date-time), required format: yyyy-MM-dd’T’HH:mm:ss.SSSz

Date and time the transaction was created in the RocketKOR system.

 

debitFinancialAccountSnapshotId

string (UUID)

ID for the snapshot of the Financial Account used as the funding account. This information is captured in order to have a record of the account at the time of the transaction.

 

maskedDebitAccountNumber

string

Masked number for the bank account or card account linked to the Financial Account.

 

creditFinancialAccountSnapshotId

string (UUID)

ID for the snapshot of the Financial Account used as the deposit account. This information is captured in order to have a record of the account at the time of the transaction.

 

maskedCreditAccountNumber

string

Masked number for the bank account or card account linked to the Financial Account.

 

paymentReason

string

Description of the payment reason. Use the Payment Reasons API to retrieve a list of available payment reason IDs and their corresponding descriptions.

 

requestorId

string (UUID)

ID of the entity that requested the transaction creation. This could be a RocketKOR Business Account (if the transaction is created via an API) or a Team Member (if the transaction is created in the RocketKOR Portal).

 

requestorType

string enum, values: BUSINESS_ACCOUNT, EMPLOYEE

Type of requestor specified in requestorId.

 

businessAccountId

string (UUID)

ID of the Business Account that contains the debit and credit accounts for the transaction.

 

recipientDto

object

Recipient Account details.

id

string (UUID)

Unique ID assigned to the Recipient Account.

createdAt

string (date-time), required format: yyyy-MM-dd’T’HH:mm:ss.SSSz

Date and time the Recipient Account was created.

updatedAt

string (date-time), required format: yyyy-MM-dd’T’HH:mm:ss.SSSz

Date and time the Recipient Account was last updated.

requestorId

string, max length: 40, min length: 0

ID of the entity that requested the Recipient Account creation. This could be a RocketKOR Business Account (if the account is created via an API) or a Team Member (if the account is created in the RocketKOR Portal).

businessAccountId

string (UUID)

ID of the Business Account that the Recipient Account belongs to.

clientId

string, max length: 40, min length: 0

ID of the client application interacting with the RocketKOR system.

businessRefId

string, max length: 40, min length: 0

Your organization’s internal reference number assigned to the Recipient Account. This reference number is not used by RocketKOR.

createdSource

string, max length: 40, min length: 0

Application used to create the Recipient Account, such as a RocketKOR API, the RocketKOR Portal, or an iframe.

firstName

string, max length: 40, min length: 0

Recipient’s first name.

middleName

string, max length: 40, min length: 0

Recipient’s middle name.

lastName

string, max length: 40, min length: 0

Recipient’s last name.

secondLastName

string, max length: 40, min length: 0

Recipient’s second last name.

email

string, max length: 100, min length: 0

Recipient’s email address.

phoneNumber

string, max length: 40, min length: 0

Recipient’s phone number.

nationality

string, max length: 40, min length: 0

Recipient’s nationality.

dateOfBirth

string (date), required format: YYYY-MM-DD

Recipient’s date of birth.

additionalInformation

string, max length: 500, min length: 0

Additional information or notes about the recipient.

recipientType

string, values: BUSINESS, INDIVIDUAL

Type of recipient.

businessName

string, max length: 40, min length: 0

Business name. Required if recipientType is BUSINESS.

state

string, values: ACTIVE, SUSPENDED

Current status of the Recipient Account. Possible values are ACTIVE (account is active) and SUSPENDED (account is inactive). A Recipient Account is ACTIVE when first created.

 

latestStatus

object

Current status of the transaction.

id

string (UUID)

Unique ID for the transaction status in the RocketKOR system.

createdAt

string (date-time), required format: yyyy-MM-dd’T’HH:mm:ss.SSSz

Date and time the status was assigned to the transaction.

transactionId

string (UUID)

Unique ID for the transaction in the provider system.

status

string, values: NEW, APPROVED, DECLINED, CANCELLED, REVERSED, REJECTED, SENT, SETTLED

Transaction status. Possible values include:

  • NEW  Transaction created in RocketKOR.
  • APPROVED  Disbursement approved by the provider.
  • DECLINED  Disbursement declined by the provider.
  • CANCELLED  Transaction cancelled by the user.
  • REVERSED  Transaction reversed by the user.
  • REJECTED  Transaction rejected by RocketKOR.
  • SENT  Transaction sent to the provider.
  • SETTLED  Transaction settled by the provider.

message

string, max length: 1000, min length: 0

Success or error messages related to the transaction.

SAMPLE REQUEST

				
					{
  "debitFinancialAccountId": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
  "creditFinancialAccountId": "4py56a34-4686-1539-c2ga-1a723g55dlq3",
  "paymentReasonId": "8th32z87-3845-9810-v7gu-1f827g98swk3",
  "amount": 1000.00,
  "provider": "MC_SEND",
  "currency": "USD",
  "countryCode": "CAN",
  "requestedSendDate": "",
  "receiverId": "7wu45p35-2178-3098-x6wg-2s749k37alk2",
  "receiverType": "RECIPIENT"
}
				
			

SAMPLE RESPONSE

				
					{
  "id": "2av81w47-9367-1295-h4ng-1q520p28wfn1",
  "createdAt": "2021-07-01T17:40:22.601Z",
  "debitFinancialAccountId": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
  "debitFinancialAccountSnapshotId": "1wl83a98-1243-6856-g3sg-2s680s13pkm3",
  "maskedDebitAccountNumber": "**** 5784",
  "creditFinancialAccountId": "4py56a34-4686-1539-c2ga-1a723g55dlq3",
  "creditFinancialAccountSnapshotId": "5ws94h37-1792-6523-r3jn-9z754i34kin5",
  "maskedCreditAccountNumber": "**** 6999",
  "paymentReasonId": "bf982522-d9f4-461e-8e33-4e3fbd44176d",
  "paymentReason": "Reimbursement of customer expenses",
  "amount": 1000.00,
  "provider": "MC_SEND",
  "currency": "USD",
  "countryCode": "CAN",
  "requestorId": "9qw98h31-3978-2498-g2ko-8w965t32kwe6",
  "requestorType": "BUSINESS_ACCOUNT",
  "requestedSendDate": "",
  "businessAccountId": "4hy47a98-2453-9867-u3qa-5p347q98kim4",
  "receiverId": "7wu45p35-2178-3098-x6wg-2s749k37alk2",
  "receiverType": "RECIPIENT",
  "recipientDto": {
    "id": "9kj43t32-2956-2886-x7dy-6r821w39kra3",
    "requestorId": "8hb21a87-3985-9217-a6zq-5y643x47hsa7",
    "businessAccountId": "4hy47a98-2453-9867-u3qa-5p347q98kim4",
    "clientId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "createdAt": "2021-07-01T17:40:22.601Z",
    "businessRefId": "6ja43q62-0978-2536-b5ap-4i872q65kjt3",
    "createdSource": "SDK iOS",
    "firstName": "John",
    "middleName": "",
    "lastName": "Smith",
    "secondLastName": "",
    "email": "jsmith@xyz.com",
    "phoneNumber": "4161234567",
    "nationality": "Canadian",
    "dateOfBirth": "1970-07-08",
    "additionalInformation": "",
    "recipientType": "INDIVIDUAL",
    "businessName": "",
    "state": "ACTIVE"
  },
  "latestStatus": {
    "id": "7wd40g39-2150-2435-c3hy-3c216e28bzj0",
    "createdAt": "2021-07-01T17:40:22.601Z",
    "transactionId": "2av81w47-9367-1295-h4ng-1q520p28wfn1",
    "status": "NEW",
    "message": "Transaction creation successful"
  }
}