主页API Reference
搜索
⌃K
Links

集成清单

为了确保您集成 AsiaBill 完整的流程，请完成以下必要的清单

获取测试账号信息

  1. 1.
    根据您当前需要的环境获取API地址常量​
  2. 2.
    根据您的需求选择你的需要的测试账号​
  3. 3.
    您需要获得对应的 网关号 和 signKey，添加到代码中

进行付款

  1. 1.
    你可以通过站内支付，跳转支付，直连支付的方式集成
  2. 2.
    如果出现异常可以查询常见错误码或者常见问题​
  3. 3.
    测试支付：成功交易，失败交易，3D交易
  4. 4.
    检查特定参数的必要性
    • callbackUrl：接收异步回调
    • goodsDetails：商品信息
    • customerIp：客户ip（非跳转支付时必须）
  5. 5.
    不同交易结果的处理

支付结果跳转

跳转支付，本地支付，3D交易完成交易后，重定向到的returnUrl。
  1. 1.
    处理url中的交易信息
  2. 2.
    验证返回结果中的签名信息，并正确获取支付结果，更新您的网站订单状态
  3. 3.
    成功交易：重定向到成功页面
  4. 4.
    失败交易：展示失败原因信息

上传物流

您的订单发货后需上传物流信息到 AsiaBill 系统进行结算审核。

通知Webhook

AsiaBill 依靠交易通知webhook来通知您的系统支付结果，在某些情况下还有其他的事件，例如退款结果事件，拒付事件等。
  1. 1.
    确保您的callbackUrl能接收我们的webhook
  2. 2.
    接收并处理通知，验证返回结果中的签名信息，并正确获取支付结果，更新您的网站订单状态
  3. 3.
    输出success报文表示处理成功

上线

您需要一个正式的账号开始 AsiaBill 的付款。
把接口地址切换为生产环境​
站内支付同时还需要把加载的js脚本切换为生产环境
​
除了必要的集成，您还可以选择以下需要的清单
如您的系统不集成以下清单，可在AsiaBill商户后台进行操作

授权交易完成/撤销

  1. 1.
    预授权完成，交易成功。
  2. 2.
    预授权撤销，交易失败。

交易查询

如需要获订单的交易信息或者核对订单状态，可以进行交易查询。
  1. 1.
    交易流水查询，批量查询交易信息
  2. 2.
    订单信息查询，根据orderId查询交易信息

进行退款

如需要在您的系统中完成退款操作。
  1. 1.
    退款申请
    • 申请成功，退款结果由webhook通知
    • 申请失败
  2. 2.
    退款查询
以前
货币
下一个 - 支付
更多支付场景
最近更新 6mo ago