跳转到主要内容
WEBHOOK
networkProtectionFee
{
  "version": "V1.6.0",
  "event_name": "ISSUING",
  "event_type": "card.risk_control.network_protection.enrollment_fee.charged",
  "event_id": "8a78af1e-de83-43a5-b177-ecbc6a8a9fc6",
  "source_id": "ASAF_REC_xxx",
  "data": {
    "card_id": "CARD_xxx",
    "action_code": "41",
    "transaction_id": "TXN_xxx",
    "transaction_type": "FEE",
    "remark": "ASAF enrollment fee, card=****1234, action_code=41",
    "transaction_amount": 1,
    "transaction_currency": "USD",
    "transaction_time": "2026-04-23T10:00:00Z",
    "posted_time": "2026-04-23T10:01:00Z",
    "transaction_status": "APPROVED",
    "balance_amount": 49
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Event Types

Event TypeDescription
card.risk_control.network_protection.enrollment_fee.chargedOne-off enrollment fee charged against a specific card.
card.risk_control.network_protection.maintenance_fee.chargedMonthly maintenance fee charged against an account, aggregating all cards enrolled in the billing period.

请求体

application/json
​
event_id
string<uuid>
必填

A unique identifier for this event.

​
event_name
enum<string>
必填

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

可用选项:
ISSUING
​
event_type
enum<string>
必填

The specific event type that occurred.

可用选项:
card.risk_control.network_protection.enrollment_fee.charged,
card.risk_control.network_protection.maintenance_fee.charged
​
source_id
string
必填

ASAF record ID (enrollment fee) or ASAF billing ID (maintenance fee).

​
version
string
必填

API version number.

示例:

"V1.6.0"

​
data
object

Fee charge carried by enrollment_fee.charged and maintenance_fee.charged events.

Field presence differs by event type:

  • Enrollment fee (...enrollment_fee.charged) — carries card_id and action_code.
  • Maintenance fee (...maintenance_fee.charged) — carries account_id, billing_period, and card_count.

All remaining fields are present for both events.

响应

200

Return 200 to acknowledge receipt.