集成清单

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

获取测试账号信息

1. 根据您当前需要的环境获取API地址常量

2. 根据您的需求选择你的需要的测试账号

3. 您需要获得对应的 网关号 和 signKey，添加到代码中

进行付款

1. 你可以通过站内支付，跳转支付的方式集成

2. 如果出现异常可以查询常见错误码或者常见问题

3. 测试支付：成功交易，失败交易，3D交易

4. 检查特定参数的必要性

   • callbackUrl：接收异步回调

   • goodsDetails：商品信息

   • customerIp：客户ip（非跳转支付时必须）

5. 不同交易结果的处理

支付结果跳转

跳转支付，本地支付，3D交易完成交易后，重定向到的returnUrl。

1. 处理url中的交易信息

2. 验证返回结果中的签名信息，并正确获取支付结果，更新您的网站订单状态

3. 成功交易：重定向到成功页面

4. 失败交易：展示失败原因信息

上传物流

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

通知Webhook

AsiaBill 依靠交易通知webhook来通知您的系统支付结果，在某些情况下还有其他的事件，例如退款结果事件，拒付事件等。

1. 确保您的callbackUrl能接收我们的webhook

2. 接收并处理通知，验证返回结果中的签名信息，并正确获取支付结果，更新您的网站订单状态

3. 输出success报文表示处理成功

上线

您需要一个正式的账号开始 AsiaBill 的付款。

把接口地址切换为生产环境

站内支付同时还需要把加载的js脚本切换为生产环境

除了必要的集成，您还可以选择以下需要的清单

如您的系统不集成以下清单，可在AsiaBill商户后台进行操作

授权交易完成/撤销

需要预授权交易。

1. 预授权完成，交易成功。

2. 预授权撤销，交易失败。

交易查询

如需要获订单的交易信息或者核对订单状态，可以进行交易查询。

1. 交易流水查询，批量查询交易信息

2. 订单信息查询，根据orderId查询交易信息

进行退款

如需要在您的系统中完成退款操作。

1. 退款申请

   • 申请成功，退款结果由webhook通知

   • 申请失败

2. 退款查询