> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 数据参考

> Waffo 状态码、枚举值、支付方式类型及通用约定的完整参考。

## 订单状态

| 状态                       | 描述              | 终态 |
| ------------------------ | --------------- | -- |
| `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](https://en.wikipedia.org/wiki/ISO_8601)，毫秒精度（例如 `2023-04-01T03:00:00.000Z`）         |
| 币种     | [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)（例如 `IDR`, `PHP`, `HKD`, `USD`）              |
| 国家代码   | [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3)（例如 `IDN`, `PHL`, `HKG`） |
| 金额     | String 类型，精确到小数点后 2 位（例如 `"2.27"`）                                                             |
| 语言     | IETF BCP 47（例如 `id-ID`, `zh-Hant-HK`）                                                          |
| 成功响应码  | `"0"`（不是 `"SUCCESS"`）                                                                          |
| 响应消息字段 | `msg`（不是 `message`）                                                                            |