Retrieve a Transaction

Retrieve details for a transaction. You can also request the following subresources for the transaction: the credit Financial Account details, the credit Financial Account balances, the debit Financial Account details, the credit Financial Account balances, the Recipient Account that owns the debit Financial Account, and the Provider details.

Endpoint

GET /v1/transactions/{transactionId}

Authorization Header

Authorization: Bearer <access_token>

Path Parameters

transactionId REQUIRED

string (UUID)

Transaction ID in the RocketKOR system.

Query Parameters

embed

string, values: creditFinancialAccount, creditFinancialAccount.balances, debitFinancialAccount, debitFinancialAccount.recipient, transactionProviderDetails

Specify subresources to embed in the response. The subresources are returned in the _embedded object. The following subresources can be requested:

creditFinancialAccount Details for the credit Financial Account for the transaction.
creditFinancialAccount.balances Balances for the credit Financial Account for the transaction. Balances are only returned for internal RocketKOR Financial Accounts. Balances are not returned for external accounts, such as a Recipient debit card.
debitFinancialAccount Details for the debit Financial Account for the transaction.
debitFinancialAccount.balances Balances for the debit Financial Account for the transaction. Balances are only returned for internal RocketKOR Financial Accounts. Balances are not returned for external accounts, such as a Recipient debit card.
debitFinancialAccount.recipient Details for the Recipient Account that owns the debit Financial Account. Only available for debit card Financial Accounts.
transactionProviderDetails Details for the Provider facilitating the transaction.

Use a comma-separated list to return multiple subresources (example: creditFinancialAccount,creditFinancialAccount.balances).

Request Body

None

Returns

Returns the transaction details, including a unique ID for the transaction. For details, see the Transaction object.

The _embedded object contains any requested subresources, including:

creditFinancialAccount Returns the Credit Financial Account object.
creditFinancialAccount.balances Returns the Financial Account Balances object.
debitFinancialAccount Returns the Debit Financial Account object.
debitFinancialAccount.balances Returns the Financial Account Balances object.
debitFinancialAccount.recipient Returns the Recipient object.
transactionProviderDetails Returns the Transaction Provider Details object.

SAMPLE RESPONSE

				
					{
  "id": "2av81w47-9367-1295-h4ng-1q520p28wfn1",
  "businessAccountId": "4hy47a98-2453-9867-u3qa-5p347q98kim4",
  "metadata": {
    "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": "loan-payouts",
  "paymentReason": "Loan Payouts",
  "amount": "1000.00",
  "currency": "USD",
  "settlementPriority": "SAME_DAY",
  "latestStatus": {
    "status": "NEW",
    "message": "Transaction creation successful",
    "createdAt": "2021-07-01T17:40:22.601Z"
  },
  "createdAt": "2021-07-01T17:40:22.601Z",
  "createdBy": {
    "id": "3a3d03c0-bdff-464d-9220-7cc198b11bba",
    "type": "EMPLOYEE"
  },
  "reversalReason": "",
  "_embedded": {
    "creditFinancialAccount": {
      "id": "4py56a34-4686-1539-c2ga-1a723g55dlq3",
      "businessAccountId": "4hy47a98-2453-9867-u3qa-5p347q98kim4",
      "name": "Savings",
      "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",
      "bankAccount": {
        "type": "CHECKING",
        "bankName": "CitiBank",
        "routingNo": "321171184",
        "accountNumber": "89674523",
        "nameOnAccount": "Mark Strong",
        "businessName": "GLOBAL"
      },
      "_embedded": {
        "balances": {
          "USD": {
            "accountBalance": "1000.00",
            "availableBalance": "800.00",
            "pendingWithdrawals": "200.00",
            "pendingDeposits": "500.00"
          },
          "CAD": {
            "accountBalance": "600.00",
            "availableBalance": "550.00",
            "pendingWithdrawals": "50.00",
            "pendingDeposits": "300.00"
          }
        }
      }
    },
    "debitFinancialAccount": {
      "id": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
      "businessAccountId": "d7e3d57b-c2e2-4964-95a0-29ad87ab0f05",
      "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",
      },
      "_embedded": {
        "balances": {
          "USD": {
            "accountBalance": "1500.00",
            "availableBalance": "1300.00",
            "pendingWithdrawals": "200.00",
            "pendingDeposits": "100.00"
          },
          "CAD": {
            "accountBalance": "1600.00",
            "availableBalance": "1200.00",
            "pendingWithdrawals": "400.00",
            "pendingDeposits": "300.00"
          }
        }
      },
      "_embedded": {
        "recipient": {
          "id": "6a017f06-83a3-44b7-be6f-5e5cae4a9ed7",
          "businessAccountId": "8th32z87-3845-9810-v7gu-1f827g98swk3",
          "businessRefId": "RECIP001",
          "firstName": "John",
          "middleName": "",
          "lastName": "Smith",
          "secondLastName": "",
          "email": "jsmith@xyz.com",
          "phoneNumber": "4161234567",
          "nationality": "Canadian",
          "dateOfBirth": "1970-07-08",
          "additionalInformation": "",
          "recipientType": "INDIVIDUAL",
          "businessName": "",
          "state": "ACTIVE",
          "createdAt": "2021-07-08T20:56:35.219Z",
          "updatedAt": "2021-07-08T20:56:35.219Z",
          "requestorId": "9kj43t32-2956-2886-x7dy-6r821w39kra3"
        }
      }
    },
    "transactionProviderDetails": {
      "mastercard-send": {
        "disbursementId": "string",
        "paymentType": "BDB",
        "mcc": "6536",
        "cardAcceptorId": "CardAcceptor123",
        "network": "MasterCard",
        "networkStatusCode": "00",
        "networkStatusDescription": "Approved",
        "fundsAvailability": "IMMEDIATE",
        "statementDescriptor": "CLAIM 12345"
      }
    }
  }
}