订单状态
| 状态 | 描述 | 终态 |
|---|---|---|
PAY_IN_PROGRESS | 订单已受理；用户正在支付 | 否 |
AUTHORIZATION_REQUIRED | 该支付方式需要用户授权 | 否 |
AUTHED_WAITING_CAPTURE | 已授权，等待扣款（卡支付） | 否 |
PAY_SUCCESS | 支付成功 | 是 |
ORDER_CLOSE | 订单已关闭（取消/失败/超时） | 是 |
订阅状态
| 状态 | 描述 | 终态 |
|---|---|---|
AUTHORIZATION_REQUIRED | 需要用户授权 | 否 |
IN_PROGRESS | 用户正在确认订阅 | 否 |
ACTIVE | 订阅已生效；将正常发起扣款 | 否 |
CLOSE | 已关闭（超时或失败） | 是 |
MERCHANT_CANCELLED | 商户已取消 | 是 |
USER_CANCELLED | 用户已取消 | 是 |
CHANNEL_CANCELLED | 渠道已取消 | 是 |
EXPIRED | 已过期 | 是 |
订阅变更状态
| 状态 | 描述 | 终态 |
|---|---|---|
IN_PROGRESS | 变更进行中 | 否 |
AUTHORIZATION_REQUIRED | 需要用户授权 | 否 |
SUCCESS | 变更成功 | 是 |
CLOSED | 变更失败/已关闭 | 是 |
退款状态
| 状态 | 描述 | 终态 |
|---|---|---|
REFUND_IN_PROGRESS | 退款处理中 | 否 |
ORDER_PARTIALLY_REFUNDED | 部分退款完成 | 是 |
ORDER_FULLY_REFUNDED | 全额退款完成 | 是 |
ORDER_REFUND_FAILED | 退款失败 | 是 |
支付方式类型
| payMethodType | 描述 |
|---|---|
CREDITCARD | 信用卡 |
DEBITCARD | 借记卡 |
EWALLET | 电子钱包 |
ONLINE_BANKING | 网银 |
DIGITAL_BANKING | 数字银行 |
OTC | 线下支付（便利店等） |
BNPL | 先买后付 |
VA | 虚拟账户 |
APPLEPAY | Apple Pay |
GOOGLEPAY | Google Pay |
常见支付方式名称
| payMethodName | 类型 | 描述 |
|---|---|---|
CC_VISA | CREDITCARD | Visa 信用卡 |
CC_MASTERCARD | CREDITCARD | Mastercard 信用卡 |
DC_VISA | DEBITCARD | Visa 借记卡 |
DC_MASTERCARD | DEBITCARD | Mastercard 借记卡 |
DANA | EWALLET | DANA 电子钱包 |
GCASH | EWALLET | GCash 电子钱包 |
LINKAJA | EWALLET | LinkAja 电子钱包 |
MERCADOPAGO | EWALLET | Mercadopago |
APPLEPAY | APPLEPAY | Apple Pay |
GOOGLEPAY | GOOGLEPAY | Google Pay |
SPEI | ONLINE_BANKING | SPEI（墨西哥） |
JENIUSPAY | ONLINE_BANKING | JeniusPay（印度尼西亚） |
AKULAKU | BNPL | Akulaku |
KREDIVO | BNPL | Kredivo |
INDODANA | BNPL | Indodana |
OXXO | OTC | OXXO（墨西哥） |
OXXOPAY | OTC | OXXO Pay（墨西哥） |
用户终端类型
| userTerminal | 描述 |
|---|---|
WEB | Web |
APP | 移动应用 |
IN_WALLET_APP | 钱包内应用 |
IN_MINI_PROGRAM | 小程序 |
Webhook 事件类型
| eventType | 描述 |
|---|---|
PAYMENT_NOTIFICATION | 支付结果通知 |
REFUND_NOTIFICATION | 退款结果通知 |
SUBSCRIPTION_STATUS_NOTIFICATION | 订阅状态变更 |
SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION | 订阅周期变更 |
SUBSCRIPTION_CHANGE_NOTIFICATION | 订阅升/降级完成 |
退款来源
| refundSource | 描述 |
|---|---|
MERCHANT | 由商户发起退款 |
RDR | 快速争议解决（RDR） |
ETHOCA | Ethoca 争议解决 |
通用约定
| 项目 | 标准 |
|---|---|
| 时间格式 | ISO 8601，毫秒精度（例如 2023-04-01T03:00:00.000Z） |
| 币种 | ISO 4217（例如 IDR, PHP, HKD, USD） |
| 国家代码 | ISO 3166-1 alpha-3（例如 IDN, PHL, HKG） |
| 金额 | String 类型，精确到小数点后 2 位（例如 "2.27"） |
| 语言 | IETF BCP 47（例如 id-ID, zh-Hant-HK） |
| 成功响应码 | "0"（不是 "SUCCESS"） |
| 响应消息字段 | msg（不是 message） |