API Reference

Transaction Authorization / Reversal / Refund

Published when a transaction is authorized, reversed and refunded.

Event metadata

  • name: ISSUING
  • types:
    • issuing.transaction.authorization
    • issuing.transaction.reversal
    • issuing.transaction.refund

Request body

FieldsData TypeDescription
event_idstringA unique ID for the event.
event_namestringEvent name.
event_typestringEvent type.
source_idstringTransaction ID.
versionstringAPI Version number.
dataobjectObject containing transaction details associated with the event.

Notification example

{
    "version": "V1.5.2", 
    "event_name": "ISSUING", 
    "event_type": "issuing.transaction.authorization", 
    "event_id": "8a78af1e-de83-43a5-b177-ecbc6a8a9fc6",
  	"source_id": "dac951ae-507a-4c07-9acd-e045b7d4962f", 
    "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", 
        "original_transaction_id": "1234e6cc-28b6-4889-81dc-3b86a09e1395",
        "card_available_balance": 2005.26, 
        "transaction_type": "AUTHORIZATION",
        "transaction_fee": 0.01,
        "authorization_code": "856268", 
        "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": "5734", 
                "city": "Chicago", 
                "country": "US", 
                "name": "PAYPAL"
            }
        ], 
        "failure_reason": "1107 - Invalid CVV2", 
        "transaction_status": "DECLINED"
    }
}