Transaction

Published when a transaction is authorized, reversed and refunded.

Event metadata

  • name: ISSUING
  • types:
    • issuing.transaction.authorization
    • issuing.transaction.reversal
    • issuing.transaction.refund
    • issuing.transaction.settlement.credit
    • issuing.transaction.settlement.debit
    • issuing.transaction.settlement.reversal
    • issuing.transaction.fund.collection
    • issuing.transaction.validation
    • issuing.transaction.atm.deposit

Request body

Fields

Data Type

Description

event_id

string

A unique ID for the event.

event_name

string

Event name.

event_type

string

Event type.

source_id

string

Transaction ID.

version

string

API version number.

data

object

Object containing transaction details associated with the event.

data.description

string

  • If transaction_status is DECLINED, this field contains the reason for the failure.
  • If transaction_status is APPROVED, this field contains supplementary remarks.
    • For 3DS transactions where a fee is deducted from the card balance, this field displays the value 3DS Fee.

Notification example

{
    "version": "V1.6.0",
    "event_name": "ISSUING",
    "event_type": "issuing.transaction.authorization",
    "event_id": "8a78af1e-de83-43a5-b177-ecbc6a8a9fc6",
    "source_id": "dac951ae-507a-4c07-9acd-e045b7d4962f", // transaction_id
    "data": {
        "card_id": "c0cef051-29c5-4796-b86a-cd5b684bfad7",
        "card_number": "************5668",
        "cardholder_id": "c0cef051-29c5-4796-b86a-cd5ee34bfad7",
        "transaction_id": "5135e6cc-28b6-4889-81dc-3b86a09e1395",
        "short_transaction_id": "CT12345",
        "original_transaction_id": "1234e6cc-28b6-4889-81dc-3b86a09e1395",
        "card_available_balance": "2005.26",
        "transaction_type": "AUTHORIZATION",
        "transaction_fee": "0.01",
        "transaction_fee_currency": "USD",
        "fee_pass_through": "Y",
        "authorization_code": "856268",
        "billing_amount": "70.25",
        "billing_currency": "SGD",
        "transaction_amount": "100.25",
        "transaction_currency": "USD",
        "transaction_time": "2024-03-21T17:17:32.456+08:00",
        "posted_time": "2024-03-21T17:17:32+08:00",
        "merchant_data": [
            {
                "category_code": "5734", // MCC
                "city": "Chicago",
                "country": "US",
                "name": "PAYPAL"
            }
        ],
        "wallet_type": "ApplePay",
        "description": "1107 - Invalid CVV2",
        "transaction_status": "DECLINED"
    }
}

ATM Withdraw

category_code = 6011 [FINANCIAL INSTITUTIONS - AUTOMATED CASH DISBURSEMENTS]

{
  "version": "V1.6.0",
  "event_name": "ISSUING",
  "event_type": "issuing.transaction.authorization",
  "event_id": "d926e656-53e8-45a1-aeb7-c87504af72f5",
  "source_id": "b24530f9-5a86-4d36-b270-7ae72826eec5",
  "data": {
    "authorization_code": "MZHVQE",
    "billing_amount": "2",
    "billing_currency": "SGD",
    "card_available_balance": "995.9",
    "card_id": "4e8f8c99-47e2-40a2-990d-c6f3e821a510",
    "card_number": "40963608****9191",
    "cardholder_id": "860d89d6-4489-48df-87b1-54704ebb3277",
    "description": "",
    "fee_pass_through": "N",
    "merchant_data": [
      {
        "category_code": "6011",
        "city": "CITY NAME",
        "country": "CN",
        "name": "ACQUIRER NAME"
      }
    ],
    "original_transaction_id": "",
    "posted_time": "2025-07-22T16:19:43+08:00",
    "short_transaction_id": "T250722-FCGQQXST",
    "transaction_amount": "2",
    "transaction_currency": "SGD",
    "transaction_fee": "0",
    "transaction_fee_currency": "",
    "transaction_id": "b24530f9-5a86-4d36-b270-7ae72826eec5",
    "transaction_status": "APPROVED",
    "transaction_time": "2025-07-22T16:19:43+08:00",
    "transaction_type": "AUTHORIZATION",
    "wallet_type": ""
  }
}