Issuing Webhook Events

This directory documents all Issuing-related webhook events.

All webhooks are delivered via HTTP POST with a unified envelope structure.

Common Fields

Field	Type	Description
event_id	string	Unique event identifier
event_name	string	Always `ISSUING`
event_type	string	Specific event type
source_id	string	Source ID (order ID / transaction ID)
version	string	API version
data	object	Event payload

Event List

Card Created Event

Card Status Updated Event

Card Recharged Event

3DS OTP Event

Transaction Event

Transaction Not Supported Event

Each event is documented in a separate Markdown file.

Card Created Event(卡片创建)

Event Info

Event Name: ISSUING

Event Types:

card.create.succeeded

card.create.failed

Trigger: Fired when card creation succeeds or fails

Payload Structure

Top Level

Field	Type	Description
event_id	string	Event ID
event_type	string	Creation result
source_id	string	Card order ID
data	object	Card object

`data` Object (Card)

Field	Type	Description
card_id	string	Card ID
card_bin	string	BIN
card_scheme	string	VISA / Mastercard
card_number	string	Masked card number
form_factor	string	PHYSICAL / VIRTUAL
mode_type	string	Mode type
card_product_id	string	Card product ID
card_available_balance	string	Available balance
cardholder	object	Cardholder info
spending_limits	array	Spending rules
risk_controls	object	Risk controls
metadata	object	Custom metadata
card_status	string	Card status

`cardholder` Object

Field	Type	Description
cardholder_id	string	Cardholder ID
email	string	Email
first_name	string	First name
last_name	string	Last name
create_time	string	Created time
cardholder_status	string	Status

Card Status Updated Event(卡状态更新事件)

Event Info

Event Name: ISSUING

Event Types:

card.status.update.succeeded

card.status.update.failed

Trigger: Fired when card status update completes or fails

`data` Object

Field	Type	Description
card_id	string	Card ID
card_number	string	Masked card number
update_time	string	Update time
card_status	string	New card status
update_reason	string	Update reason

Card Status Enum

Status	Description
ACTIVE	Card active
PRE_CANCEL	Pre-cancelled
CANCELLED	Permanently cancelled
FROZEN	Temporarily frozen
BLOCKED	Blocked due to risk

Card Recharged Event(卡充值事件)

Event Info

Event Name: ISSUING

Event Types:

card.recharge.succeeded

card.recharge.failed

Trigger: Fired when card recharge completes or fails

`data` Object

Field	Type	Description
card_id	string	Card ID
amount	string	Recharge amount
card_available_balance	string	Balance after recharge
card_currency	string	Currency
update_time	string	Update time
complete_time	string	Completion time
card_status	string	Card status
order_status	string	Order status

Order Status Enum

Status	Description
SUCCESS	Recharge succeeded
FAILED	Recharge failed
PENDING	Pending
PROCESSING	Processing

3DS OTP Event(3D验证事件)

Event Info

Event Name: ISSUING

Event Type: card.3ds.otp

Trigger: Fired when a transaction requires 3D Secure verification

`data` Object

Field	Type	Description
reference_code	string	OTP reference code
otp	string	One-time password
customer_id	string	Customer ID
card_id	string	Card ID
card_number	string	Masked card number
transaction_currency	string	Currency
transaction_amount	string	Amount
merchant_name	string	Merchant name

Transaction Event(交易事件)

Event 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

issuing.transaction.chargeback.credit

issuing.transaction.chargeback.debit

`data` Object

Field	Type	Description
card_id	string	Card ID
card_number	string	Masked card number
cardholder_id	string	Cardholder ID
transaction_id	string	Transaction ID
short_transaction_id	string	Short ID
original_transaction_id	string	Original transaction
card_available_balance	string	Balance after
transaction_type	string	Transaction type
transaction_fee	string	Fee
transaction_fee_currency	string	Fee currency
fee_pass_through	string	Y / N
authorization_code	string	Auth code
billing_amount	string	Billing amount
billing_currency	string	Billing currency
transaction_amount	string	Amount
transaction_currency	string	Currency
transaction_time	string	Transaction time
posted_time	string	Posted time
merchant_data	array	Merchant info
wallet_type	string	Wallet type
description	string	Remark or decline reason
transaction_status	string	APPROVED / DECLINED

`merchant_data`

Field	Type	Description
category_code	string	MCC
city	string	City
country	string	Country
name	string	Merchant name

WebHook通知事件

Issuing Webhook Events#

Common Fields#

Event List#

Card Created Event(卡片创建)#

Event Info#

Payload Structure#

Top Level#

data Object (Card)#

cardholder Object#

Card Status Updated Event(卡状态更新事件)#

Event Info#

data Object#

Card Status Enum#

Card Recharged Event(卡充值事件)#

Event Info#

data Object#

Order Status Enum#

3DS OTP Event(3D验证事件)#

Event Info#

data Object#

Transaction Event(交易事件)#

Event Types#

data Object#

merchant_data#

Issuing Webhook Events

Common Fields

Event List

Card Created Event(卡片创建)

Event Info

Payload Structure

Top Level

`data` Object (Card)

`cardholder` Object

Card Status Updated Event(卡状态更新事件)

Event Info

`data` Object

Card Status Enum

Card Recharged Event(卡充值事件)

Event Info

`data` Object

Order Status Enum

3DS OTP Event(3D验证事件)

Event Info

`data` Object

Transaction Event(交易事件)

Event Types

`data` Object

`merchant_data`