Search SLTs

Search for single-leg transactions (SLTs) based on filters such as the date, amount, status, and account. Use the sort query parameter to sort the results, and use the page and size query parameters to limit the number of results returned.

Note  The search is limited to transactions for the Business Account associated with the request access token.

Endpoint

GET /v1/transactions

Authorization Header

Authorization: Bearer <access_token>

Query Parameters

requestorId

string (UUID)

ID of the entity that created the transaction.

requestorType

string enum, values: employee, internal, service-account

Type of entity that created the transaction. The following values are supported:

  • employee  Team Member using the RocketKOR Portal.
  • internal  Internal service call.
  • service-account  Service Account using APIs.

createdDateFrom

string (date), format: yyyy-MM-dd

Date the transaction was created in the RocketKOR system. This filter will return transactions created on or after this date.

Note  The date is interpreted using the time zone specified in the timeZone filter. UTC format is used if timeZone is not provided.

createdDateTo

string (date), format: yyyy-MM-dd

Date the transaction was created in the RocketKOR system. This filter will return transactions created on or before this date.

Note  The date is interpreted using the time zone specified in the timeZone filter. UTC format is used if timeZone is not provided.

timeZone

string (timeZone), default value: UTC

Time zone for the createdDateFrom and createdDateTo filters. The following values are supported:

  • Z, UTC or GMT  UTC
  • {+,-}N(N)(:MM)  Zone offset in hours and minutes
  • UTC+<offset>, UTC-<offset>, GMT+<offset>, GMT-<offset>
  • IANA Time Zone Database region ID (example: the value for America/New_York is -04)

amountFrom

number

Transaction amount. This filter will return transactions with an amount equal to or greater than this amount.

amountTo

number

Transaction amount. This filter will return transactions with an amount equal to or less than this amount.

latestStatus

string enum, values: NEW, PENDING, PROCESSING, APPROVED, SETTLED, CLEARED, CANCELLED, DECLINED, REVERSED, ERROR

Transaction status. The following values are supported:

  • NEW  The transaction has been created in RocketKOR.
  • PENDING  The transaction has been moved from the RocketKOR Transaction Domain to one of the RocketKOR Processing Domains. The transaction is still in the RocketKOR system (meaning it has not been transmitted to the Provider for processing) and is in a state where it can be cancelled.
  • PROCESSING  One of the following is true: (a) the transaction is in a RocketKOR Processing Domain but can no longer be cancelled, or (b) the transaction has been transmitted to the Provider for processing.
  • APPROVED  Disbursement has been approved by the Provider.
  • SETTLED  The transaction has been settled by the Provider.
  • CLEARED  The Sponsor has indicated that funds movement for the transaction is complete. The funds are now available in the Master Settlement Account (MSA). This status is only applicable for “received” transactions.
  • CANCELLED  The transaction has been cancelled.
  • DECLINED  Disbursement has been declined by the Provider.
  • REVERSED  A transaction was submitted by RocketKOR to move funds in the opposite direction of the initial transaction. This “reverses” the transaction by moving the funds back to the original account.
  • ERROR  The transaction could not be processed due to one or more errors (for example, the Provider system is unavailable after a number of retries). The ERROR status is only activated after RocketKOR determines that it cannot continue processing the transaction.

maskedDebitAccountNumber

string

Masked account number for the bank or card account used as the debit account for the transaction. Enter the last 4 digits of the account number (for example: 4242). Optionally, you can enter asterisks for the rest of the account number (for example: ********4242).

maskedCreditAccountNumber

string

Masked account number for the bank or card account used as the credit account for the transaction. Enter the last 4 digits of the account number (for example: 4242). Optionally, you can enter asterisks for the rest of the account number (for example: ********4242).

solution

string

Name of the RocketKOR solution used for the transaction.

transactionTypes

array of strings

Types of transactions to retrieve. The following values are supported:

  • SEND  Push funds from the debit Financial Account to the credit Financial Account. For example, a SEND transaction would be used if a Business Account (owner of the debit Financial Account) is sending a refund to a Customer (owner of the credit Financial Account).
  • REQUEST  Pull funds to the credit Financial Account from the debit Financial Account. For example, a REQUEST transaction would be used if a Business Account (owner of the credit Financial Account) is collecting a rent payment from a Customer (owner of the debit Financial Account).
  • DEPOSIT  Push funds into a Financial Account where the push is originated outside RocketKOR.
  • WITHDRAWAL  Pull funds from a Financial Account where the pull is originated outside RocketKOR.
  • REVERSAL  A transaction created by RocketKOR to reverse a SETTLED or CLEARED transaction.
  • RETURN  A RETURN transaction cancels the original transaction.
  • ADJUSTMENT  An ADJUSTMENT transaction is used to correct a human or system error with a transaction or to record a transaction that originated outside of RocketKOR.

origin

string enum, values: SINGLE, BATCH

Whether the transaction originated from a single transaction request or from a transaction batch.

batchId

string (UUID)

ID of the batch from which the transaction originated.

page

integer (int32)

Page number to return, based on zero-based page indexing.

size

integer (int32)

Maximum number of results to return per page.

sort

array [string]

Sort the response by any field in ascending or descending order. The default sort order is createdAt,DESC. For more information, see Sorting and Pagination.

Request Body

None

Returns

Returns a paginated response with an array of SLT objects.

SAMPLE RESPONSE

				
					{
  "totalElements": 100,
  "totalPages": 20,
  "number": 0,
  "numberOfElements": 5,
  "hasNext": true,
  "content": [
    {
      "businessAccountId": "de30132c-e67a-4af7-89ec-f2109863b7f7",
      "metadata": {
        "rkorACHEntryType": "CCD",
        "myPaymentId": "100000333",
        "invoiceNumber": "123232333",
        "authorizedBy": "user@email.com"
      },
      "debitFinancialAccountId": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
      "creditFinancialAccountId": "4py56a34-4686-1539-c2ga-1a723g55dlq3",
      "transactionType": "SEND",
      "solution": "ach",
      "paymentReasonId": "bill-payment",
      "paymentReason": "Bill payment",
      "amount": "1000.00",
      "currency": "USD",
      "settlementPriority": "SAME_DAY",
      "createdAt": "2021-07-01T17:40:22.601Z",
      "createdBy": {
        "id": "b6333b53-3222-4227-a71e-718b25ca3ea4",
        "type": "service-account"
      },
      "description": "",
      "memo": "",
      "initiatorAccountHolderId": "ebfa3e16-63c4-48e3-ae59-a3194a867269",
      "externalTransactionInitiatorId": "c62d1e6b-39ce-496e-bf6d-8a019d2f534e",
      "originatingChannel": "EXTERNAL",
      "id": "2av81w47-9367-1295-h4ng-1q520p28wfn1",
      "latestStatus": {
        "status": "NEW",
        "message": "Transaction creation successful",
        "createdBy": {
          "id": "b6333b53-3222-4227-a71e-718b25ca3ea4",
          "type": "service-account"
        },
        "createdAt": "2021-07-01T17:40:22.601Z"
      },
      "reversalReason": ""
    },
    {...},
    {...},
    {...},
    {...}
  ]
}
				
			
Exit mobile version