Skip to main content
WEBHOOK
cardFee
{
  "version": "V1.6.0",
  "event_name": "ISSUING",
  "event_type": "issuing.fee.card",
  "event_id": "f6a45004-e613-4572-a519-ab5c7f7db35e",
  "source_id": "241f91dc-e6cf-45cd-bbbe-9757da871932",
  "data": {
    "billing_amount": "5",
    "billing_currency": "USD",
    "card_available_balance": "45",
    "card_id": "2f04dc5c-16dd-401a-90c2-e74390f46692",
    "card_number": "40963608****3820",
    "cardholder_id": "3a1d3ce4-977b-4f1d-8076-8d2dd59e942c",
    "posted_time": "2026-04-11T18:23:03+08:00",
    "reference_id": "241f91dc-e6cf-45cd-bbbe-9757da871932",
    "remark": "deduct physical card [3820] maintenance fee 5 USD",
    "short_reference_id": "CL260411-2AEQBW2AQUPS",
    "transaction_amount": "5",
    "transaction_currency": "USD",
    "transaction_status": "APPROVED",
    "transaction_time": "2026-04-11T18:23:03+08:00",
    "transaction_type": "FEE"
  }
}

​
Event Types

Event TypeDescription
issuing.fee.cardA fee was deducted from the card.

Body

application/json
​
event_id
string<uuid>
required

A unique identifier for this event.

​
event_name
enum<string>
required

Top-level event category. Always ISSUING for card issuance events.

Available options:
ISSUING
​
event_type
enum<string>
required

The specific event type that occurred.

Available options:
issuing.fee.card
​
source_id
string
required

Original transaction ID, finance transaction ID, or ledger ID.

​
version
string
required

API version number.

Example:

"V1.6.0"

​
data
object

Fee deduction details.

Response

200

Return 200 to acknowledge receipt.