Changelog

​

API Enhancements

• Invalid ID (name check hit) - The cardholder’s name triggered a name screening check
• Invalid ID (exceed the company's risk appetite) - The application exceeds the company’s risk appetite threshold

• Additional Doc for Non-HK Resident (missing id back photo) - The back photo of the ID document is missing

• Invalid ID (name check hit) - 持卡人姓名觸發了姓名篩查
• Invalid ID (exceed the company's risk appetite) - 申請超出公司風險承受範圍

• Additional Doc for Non-HK Resident (missing id back photo) - 缺少身份證件背面照片

​

API Enhancements

• charge - Card purchase or payment authorization
• refund - Reversal or refund of a previous charge
• topup - Funds loaded into the card account
• withdraw - Funds withdrawn (e.g. ATM or cash advance)
• repay - Repayment towards outstanding balance
• cashback - Cashback reward credited to the account
• interest - Interest accrued on outstanding balance
• transfer - Balance transfer between card accounts
• fee - Service fees (e.g. annual fee, late payment fee)
• other - Uncategorized transaction types

• Incomplete Info (not residential address) - The address provided is not a valid residential address

• charge - 卡片消費或支付授權
• refund - 退款或撤銷先前的消費
• topup - 資金存入卡賬戶
• withdraw - 資金提取（如 ATM 或現金預借）
• repay - 償還未清餘額
• cashback - 現金回饋獎勵
• interest - 未清餘額的利息
• transfer - 卡賬戶之間的餘額轉帳
• fee - 服務費用（如年費、逾期還款費）
• other - 未分類的交易類型

• Incomplete Info (not residential address) - 提供的地址不是有效的住宅地址

​

New Features

​

What’s New:

​

Usage:

​

Example Request:

{
  "cardAccountId": "123e4567-e89b-12d3-a456-426614174000",
  "action": "reject",
  "rejectedReason": "Document expired"
}

​

新增內容：

​

使用方法：

​

請求範例：

{
  "cardAccountId": "123e4567-e89b-12d3-a456-426614174000",
  "action": "reject",
  "rejectedReason": "Document expired"
}

​

API Enhancements

• Additional Doc for Non-HK Resident (document type not accepted) - The submitted document type is not accepted
• Additional Doc for Non-HK Resident (expired document) - The submitted document has expired
• Additional Doc for Non-HK Resident (unclear image) - The document image quality is insufficient
• Additional Doc for Non-HK Resident (document not belong to client) - The document does not belong to the applicant
• Additional Doc for Non-HK Resident (potential bogus document) - The document appears to be fraudulent

​

Important Update

​

What’s Changing:

• TRAVEL_PERMIT_FRONT - Front side of the permit
• TRAVEL_PERMIT_BACK - Back side of the permit

​

Example Submission:

{
  "supportingDocuments": [
    {
      "documentType": "TRAVEL_PERMIT_FRONT",
      "file": "data:image/jpeg;base64,..."
    },
    {
      "documentType": "TRAVEL_PERMIT_BACK",
      "file": "data:image/jpeg;base64,..."
    }
  ]
}

​

變更內容：

• TRAVEL_PERMIT_FRONT - 通行證正面
• TRAVEL_PERMIT_BACK - 通行證背面

​

提交範例：

{
  "supportingDocuments": [
    {
      "documentType": "TRAVEL_PERMIT_FRONT",
      "file": "data:image/jpeg;base64,..."
    },
    {
      "documentType": "TRAVEL_PERMIT_BACK",
      "file": "data:image/jpeg;base64,..."
    }
  ]
}

​

Important Updates

• occupation - Select from /v1/occupations endpoint
• position - Select from /v1/positions endpoint
• gender - MALE or FEMALE
• nationality - ISO 3166-1 alpha-2 format (e.g., HK)
• supportingDocuments - Required for non-Hong Kong (HK) nationals (see accepted document types →)

• occupation（職業）- 從 /v1/occupations 端點選擇
• position（職位）- 從 /v1/positions 端點選擇
• gender（性別）- MALE 或 FEMALE
• nationality（國籍）- ISO 3166-1 alpha-2 格式（例如：HK）
• supportingDocuments（證明文件）- 非香港 (HK) 國籍申請人必須提供（查看可接受的文件類型 →）

​

New Features

​

New Features

• Auto-Recovery: Suspended webhooks are automatically pinged every 5 minutes for up to 24 hours
• Automatic Resumption: If a ping succeeds, webhook delivery resumes automatically without manual intervention
• Auto-Deletion: Webhooks are automatically deleted if they remain suspended with failed recovery pings for 24 consecutive hours