Sign in

v1

latestOpenAPI 3.0.22026-07-26123510445.2 KB
Transactions

Retrieve Cards Transaction

Returns an issuing transaction objects associated with the provided transaction id.

get/v1/issuing/transactions/{id}

Path parameters

idstring required
Example:c0cef051-29c5-4796-b86a-cd5b684bfad7

Unique identifier for the cards transaction.

Headers

x-on-behalf-ofstring

Specifies the sub-account on whose behalf the request is made. This should be set to the account_id, which can be retrieved via the List Connected Accounts API. If omitted or empty, the request is executed using the master account. More information at Connected Accounts.

Response

OK - Card transaction returned successfully.

card_idstring required

Unique identifier for the card.

card_numberstring required

Masked card number

cardholder_idstring uuid required

The cardholder's unique identifier.

transaction_idstring uuid required

Unique Identifier for transaction

short_transaction_idstring uuid required

Short unique identifier for transaction.

original_transaction_idstring uuid required

Unique Identifier for the original transaction.

transaction_type'AUTHORIZATION' | 'REFUND' | 'FUND COLLECTION' | 'ATM DEPOSIT' | 'REVERSAL' | 'VALIDATION' | 'SETTLEMENT DEBIT' | 'SETTLEMENT CREDIT' | 'SETTLEMENT REVERSAL' | 'CHARGEBACK DEBIT' | 'CHARGEBACK CREDIT' required

Transaction type of card.

  • AUTHORIZATION: Funds reserved due to card usage.
  • REFUND: Refunding the purchase amount back to account balance.
  • FUND COLLECTION: Inbound funds posted to the cardholder's card account, reported by the card network. Triggered by the network (not by a cardholder API call); distinct from CARD RECHARGE.
  • ATM DEPOSIT: Funds deposited to the account via an ATM.
  • REVERSAL: Reversing an authorization.
  • VALIDATION: Card Binding Verification.
  • SETTLEMENT DEBIT: Netting and deduction of reconciliation discrepancies.
  • SETTLEMENT CREDIT: Netting and crediting of reconciliation discrepancies.
  • SETTLEMENT REVERSAL: Netting and reversal of reconciliation discrepancies.
  • CHARGEBACK DEBIT: Funds debited due to chargebacks.
  • CHARGEBACK CREDIT: Funds credited due to chargebacks.
transaction_feenumber required

Transaction fee.

transaction_fee_currencystring required

Transaction fee currency.

fee_pass_through'Y' | 'N' required

Indicates whether this transaction carries a pass-through low-transaction fee (LOW_TRANSACTION_FEE).

  • Y – The transaction triggered the low-transaction-fee rule; transaction_fee / transaction_fee_currency carry that pass-through fee.
  • N – No such pass-through fee applies (default). Only triggered when the transaction amount (in USD) falls within the card's configured low-transaction-fee threshold range.
card_available_balancenumber required

The card available balance.

authorization_codestring required

Authorization Code

billing_amountnumber required

Billing amount

billing_currencystring required

Billing Currency

transaction_amountnumber required

Transaction amount

transaction_currencystring required

Transaction currency

transaction_timestring required

Transaction occurrence time

posted_timestring

Transaction posted time

descriptionstring required

Provides additional context based on the transaction status.

  • If transaction_status is DECLINED, this field contains the reason for the failure.
  • If transaction_status is APPROVED, this field contains supplementary remarks(e.g. "1000 - Authorization Approval", "3DS Fee").
transaction_status'APPROVED' | 'DECLINED' | 'PENDING' required

The high-level status indicating the stage of the transaction lifecycle.

wallet_type'ApplePay' | 'GooglePay' | 'GOOGLE ECOMMERCE' | 'GOOGLE' | 'GOOGLE PAY'

Indicates which digital wallet was used for the transaction.

Example response

{
  "card_id": "c0cef051-29c5-4796-b86a-cd5b684bfad7",
  "card_number": "************5668",
  "cardholder_id": "7c4ff2cd-1bf6-4aaa-bf16-266771425011",
  "transaction_id": "5135e6cc-28b6-4889-81dc-3b86a09e1395",
  "short_transaction_id": "CT2024-03-01",
  "original_transaction_id": "1234e6cc-28b6-4889-81dc-3b86a09e1395",
  "transaction_type": "AUTHORIZATION",
  "transaction_fee": 0.25,
  "transaction_fee_currency": "SGD",
  "fee_pass_through": "Y",
  "card_available_balance": 2506.26,
  "billing_amount": 70.25,
  "billing_currency": "SGD",
  "transaction_amount": 100.25,
  "transaction_currency": "USD",
  "transaction_time": "2024-03-21T17:17:32+08:00",
  "posted_time": "2024-03-21T17:17:32+08:00",
  "merchant_data": {
    "category_code": "6011",
    "city": "CITY NAME",
    "country": "CN",
    "name": "ACQUIRER NAME"
  },
  "description": "1107 - Invalid CVV2",
  "transaction_status": "DECLINED",
  "wallet_type": "ApplePay"
}