跳转到主要内容

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.

订单状态

状态描述终态
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虚拟账户
APPLEPAYApple Pay
GOOGLEPAYGoogle Pay

常见支付方式名称

payMethodName类型描述
CC_VISACREDITCARDVisa 信用卡
CC_MASTERCARDCREDITCARDMastercard 信用卡
DC_VISADEBITCARDVisa 借记卡
DC_MASTERCARDDEBITCARDMastercard 借记卡
DANAEWALLETDANA 电子钱包
GCASHEWALLETGCash 电子钱包
LINKAJAEWALLETLinkAja 电子钱包
MERCADOPAGOEWALLETMercadopago
APPLEPAYAPPLEPAYApple Pay
GOOGLEPAYGOOGLEPAYGoogle Pay
SPEIONLINE_BANKINGSPEI(墨西哥)
JENIUSPAYONLINE_BANKINGJeniusPay(印度尼西亚)
AKULAKUBNPLAkulaku
KREDIVOBNPLKredivo
INDODANABNPLIndodana
OXXOOTCOXXO(墨西哥)
OXXOPAYOTCOXXO Pay(墨西哥)

用户终端类型

userTerminal描述
WEBWeb
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)
ETHOCAEthoca 争议解决

通用约定

项目标准
时间格式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(例如 en-HK, zh-Hant-HK
成功响应码"0"(不是 "SUCCESS"
响应消息字段msg(不是 message