• 简体中文
  • 数据字典

    国家码+货币类型

    国家国家码货币区号
    尼日利亚NGNGN0234
    加纳GHGHS0233
    坦桑尼亚TZTZS0255
    肯尼亚KEKES0254
    南非ZAZAR0027
    巴基斯坦PKPKR0092

    钱包枚举

    国家钱包
    巴基斯坦EASYPAISA、JAZZCASH
    坦桑M-pesa、Tigopesa、Airtel Money、Halopesa
    加纳MTN、VODAFONE、AIRTELTIGO、TIGO
    肯尼亚M-PESA

    订单状态-orderStatus

    值状态说明
    0待支付(unpaid)待支付状态(中间态)、订单有效期内等待用户支付的状态
    1支付中(pending)支付中状态(中间态),订单有效期内订单正在支付处理中
    2成功(succeeded)支付成功(终态),订单有效期内支付结果为成功
    3失败(fail)支付失败(终态),订单支付结果为失败的
    4关闭(closed)订单关闭(终态),订单有效期内,用户未完成支付的订单会关单
    5待捕获(required_capture)授权成功待捕获(captureMode=manual 时触发)

    订单状态流转说明:

    请务必填写 notify url 接收订单状态,其中 close、fail、succeeded 均会通过 notify url 异步通知

    1. 状态流转有两种:
      • unpaid → pending → succeeded/fail:正常订单流转状态
      • unpaid → closed:用户在订单有效期内未完成支付

    退款订单状态-refundOrderStatus

    退款订单状态枚举如下:

    值状态说明
    0待支付(unpaid)表示等待处理(中间态)
    1处理中(pending)表示退款处理中(中间态)
    2成功(succeeded)表示退款成功(终态)
    3失败(fail)表示退款失败(终态)
    4关闭(closed)表示退款单关闭(终态)

    Card Token 状态-tokenStatus

    Card Payment 场景下 cardToken 的状态枚举:

    值状态说明
    0初始化(init)交易初始化,尚未发起绑卡流程
    1已绑定(bound)绑卡成功,Token 可用
    3绑定失败(failed)绑卡失败(终态),Token 不可用
    4处理中(pending)绑卡处理中(中间态),等待卡组/发卡行响应
    7未认证(uncertified)交易初始化最终状态,表示 token 已生成但未通过验证流程

    Token 状态流转说明:

    0 (init) ──▶ 4 (pending) ──▶ 1 (bound)    -- 正常绑卡成功
                             │
                             └──▶ 3 (failed)   -- 绑卡失败
                    │
                    └──▶ 7 (uncertified)        -- 交易初始化后未认证(终态)

    注意: 仅 1 (bound) 状态的 Token 可用于 Create Order 中的 cardPayerInfo 下单。

    业务场景-serviceType

    值说明
    airtime话费
    dataBundle流量
    bettingFund博彩充值

    业务场景码-sceneCode

    值说明
    airtime话费
    data流量
    betting博彩充值

    Virtual Account 订单状态-orderStatus

    值说明
    0创建
    1成功(只有该状态会收到入金订单通知)
    2失败
    3处理中