数据字典

绑卡状态 bindStatus

取值 说明
INIT 已受理，等待处理
PROCESSING 处理中（用户未完成绑卡或系统处理中）
SUCCESS 终态成功
FAIL 终态失败

扣款状态 deductStatus

取值 说明
INIT 已受理
SUCCESS 扣款成功
FAIL 扣款失败
PROCESSING 处理中

异步通知 notifyType

notifyType 说明
OPEN_ACCOUNT_SUCCESS / OPEN_ACCOUNT_FAIL 绑卡+开户
BIND_CARD_SUCCESS / BIND_CARD_FAIL 绑卡
DEDUCT_SUCCESS / DEDUCT_FAIL 扣款

证件类型 idCardType / certificateType

取值 说明
ID_CARD 身份证（推荐）
ID / 01 兼容写法

网关错误码 code

同步请求失败时，由 网关/SDK 返回 code 与 message（不在 resBody 内）：

网关 code 说明 典型场景
INVALID_PARAMETER 参数错误 必填项缺失、未开户、商户号不一致
MERCHANT_NOT_FOUND 商户鉴权失败 mch_id 与 merchantId 不一致
TRADE_ERROR 交易/业务失败 产品未开通、无可用协议、扣款全失败
USER_PAYING 处理中 绑卡/扣款处理中
NOT_FOUND 记录不存在 绑卡流水/扣款单不存在
ORDER_DUPLICATED 重复请求 扣款处理中幂等
UPSTREAM_TIMEOUT 下游超时 远程调用失败
SYSTEM_ERROR 系统异常 未预期错误

主要字段含义

字段 含义
walletBizNo 绑卡主流程业务号
merchantRequestNo 商户绑卡请求流水号；幂等键之一
contractNo 钱包账户签约号；扣款 必填
agreementNo 账户协议绑定号；来自协议列表或绑卡结果
deductRequestNo 商户扣款请求号；幂等键：merchantId + deductRequestNo
deductOrderNo 扣款订单号
notifyUrl 异步通知地址
pageUrl 用户绑卡完成后浏览器回跳地址