GET STARTED

RECIPIENT

FINANCIAL ACCOUNT

PAYMENT REASON

TRANSACTION

NOTE

Retrieve a Transaction

Retrieve details for a transaction. Use the provider query parameter to filter the results by the provider facilitating the transaction.

Endpoint

GET /api/external/v1/transactions/{id}

Authorization Header

Basic Auth  REQUIRED

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

Path Parameters

id  REQUIRED

string (UUID)

Transaction ID in the RocketKOR system.

Query Parameters

provider

string enum, values: ACH, MC_SEND

Filter the results by the provider facilitating the transaction.

Request Body

None

Returns

 

Returns the transaction details. 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.

 

debitFinancialAccountId

string (UUID)

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

 

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.

 

creditFinancialAccountId

string (UUID)

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

 

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.

 

paymentReasonId

string (UUID)

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

 

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.

 

amount

number, minimum value: 0

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

 

provider

string enum, values: ACH, MC_SEND

Provider facilitating the transaction.

 

currency

string

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

 

countryCode

string, max length: 3, min length: 2

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

 

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.

 

requestedSendDate

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

Reserved for future use.

 

businessAccountId

string (UUID)

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

 

receiverId

string (UUID)

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

 

receiverType

string enum, values: BUSINESS_ACCOUNT, RECIPIENT

Type of receiver for the ID specified in receiverId.

 

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.

 

debitFinancialAccountSnapshot

object

Snapshot of the Financial Account used as the funding (debit) account. This information is captured in order to have a record of the Financial Account at the time of the transaction.

id

string (UUID)

Unique ID for the snapshot in the RocketKOR system.

createdAt

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

Date and time the snapshot was created.

financialAccountId

string (UUID)

Unique ID assigned to the Financial Account.

maskedAccountNumber

string

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

The following fields are returned if the account is a bank account.

 

bankAccount

object

Details for the bank account.

id

string (UUID)

Unique ID assigned to the bank account.

token

string (UUID)

Random alphanumeric token for the bank account details.

type

string enum, values: CHECKING, SAVING

Type of bank account.

businessName

string

Business name as it appears on the bank account.

bankName

string

Name of the financial institution.

routingNo

string

Routing number for the financial institution.

nameOnAccount

string

Name of the bank account owner.

accountNumberTail

string

Last 4 digits of the bank account number.

The following fields are returned if the account is a card account.

 

card

object

Details for the card.

id

string (UUID)

Unique ID assigned to the card.

token

string (UUID)

Random alphanumeric token for the card details.

firstName

string, max length: 40, min length: 0

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

middleName

string, max length: 40, min length: 0

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

lastName

string, max length: 40, min length: 0

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

type

string enum, values: DEBIT

Type of card.

expiry

object

Expiry information for the card.

year

integer (int32)

Expiry year.

month

string enum, values: JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER

Expiry month.

monthValue

integer (int32), values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12

Expiry month as a numeral.

leapYear

boolean (true, false)

Whether the expiry year is a leap year.

billingAddress

object

Billing address for the card.

addressLine1

string, max length: 50, min length: 0

Address line 1.

addressLine2

string, max length: 50, min length: 0

Address line 2.

addressLine3

string, max length: 50, min length: 0

Address line 3.

city

string, max length: 25, min length: 0

City.

state

string, max length: 3, min length: 2

State or province.

country

string, max length: 3, min length: 3

3-digit country code.

postalCode

string, max length: 10, min length: 0

ZIP code or postal code.

 

cardNumberTail

string

Last 4 digits of the card number.

 

crebitFinancialAccountSnapshot

object

Snapshot of the Financial Account used as the deposit (credit) account. This information is captured in order to have a record of the Financial Account at the time of the transaction.

id

string (UUID)

Unique ID for the snapshot in the RocketKOR system.

createdAt

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

Date and time the snapshot was created.

financialAccountId

string (UUID)

Unique ID assigned to the Financial Account.

maskedAccountNumber

string

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

The following fields are returned if the account is a bank account.

 

bankAccount

object

Details for the bank account.

id

string (UUID)

Unique ID assigned to the bank account.

token

string (UUID)

Random alphanumeric token for the bank account details.

type

string enum, values: CHECKING, SAVING

Type of bank account.

businessName

string

Business name as it appears on the bank account.

bankName

string

Name of the financial institution.

routingNo

string

Routing number for the financial institution.

nameOnAccount

string

Name of the bank account owner.

accountNumberTail

string

Last 4 digits of the bank account number.

The following fields are returned if the account is a card account.

 

card

object

Details for the card.

id

string (UUID)

Unique ID assigned to the card.

token

string (UUID)

Random alphanumeric token for the card details.

firstName

string, max length: 40, min length: 0

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

middleName

string, max length: 40, min length: 0

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

lastName

string, max length: 40, min length: 0

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

type

string enum, values: DEBIT

Type of card.

expiry

object

Expiry information for the card.

year

integer (int32)

Expiry year.

month

string enum, values: JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER

Expiry month.

monthValue

integer (int32), values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12

Expiry month as a numeral.

leapYear

boolean (true, false)

Whether the expiry year is a leap year.

billingAddress

object

Billing address for the card.

addressLine1

string, max length: 50, min length: 0

Address line 1.

addressLine2

string, max length: 50, min length: 0

Address line 2.

addressLine3

string, max length: 50, min length: 0

Address line 3.

city

string, max length: 25, min length: 0

City.

state

string, max length: 3, min length: 2

State or province.

country

string, max length: 3, min length: 3

3-digit country code.

postalCode

string, max length: 10, min length: 0

ZIP code or postal code.

 

cardNumberTail

string

Last 4 digits of the card number.

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"
  },
  "debitFinancialAccountSnapshot": {
    "id": "1wl83a98-1243-6856-g3sg-2s680s13pkm3",
    "createdAt": "2021-07-07T00:43:53.571Z",
    "financialAccountId": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
    "maskedAccountNumber": "**** 5784",
    "bankAccount": {
      "token": "8f8ee4f9-826d-43fe-bb15-3d737f4c2b58",
      "type": "CHECKING",
      "businessName": "ACME",
      "bankName": "CIBC",
      "routingNo": "001032352",
      "accountNumber": "12345678",
      "nameOnAccount": "Bill Smith"
    }
  },
  "creditFinancialAccountSnapshot": {
    "id": "5ws94h37-1792-6523-r3jn-9z754i34kin5",
    "createdAt": "2021-07-07T00:43:53.572Z",
    "financialAccountId": "4py56a34-4686-1539-c2ga-1a723g55dlq3",
    "maskedAccountNumber": "**** 6999",
    "card": {
      "id": "20b109f3-a339-46b3-881f-0f849aa022b1",
      "token": "ac586ef8-af78-4e94-8f87-2c9e48f274d8",
      "firstName": "Mark",
      "middleName": "David",
      "lastName": "Strong",
      "type": "DEBIT",
      "cardNumber": "84563876999",
      "expiry": {
        "year": 2022,
        "month": "JANUARY",
        "monthValue": 1,
        "leapYear": false
      },
      "addressLine1": "625 Queen St",
      "addressLine2": "",
      "addressLine3": "",
      "city": "Vancouver",
      "state": "BC",
      "country": "Canada",
      "postalCode": "V5K 0A1"
    }
  }
}