W Checkout
  1. 快速开始
W Checkout
  • 概览
  • 集成准备
  • 快速开始
    • 集成订单支付
    • 退款
    • 结算
    • Webhook
    • 枚举对照表
  • 接口目录
    • 鉴权
      • 获取AccessToken
    • 支付订单
      • CreateCheckoutOrder
      • CancelCheckoutOrder
      • GetCheckoutOrderInfo
      • GetCheckoutOrderList
    • 退款单
      • CreateRefundOrder
      • CancelRefundOrder
      • GetRefundOrderInfo
      • GetRefundOrderList
    • 结算单
      • CreateSettlementOrder
      • CreateFiatSettlementOrder
      • CancelSettlementOrder
      • GetSettlementOrder
      • GetSettlementOrderList
    • 异常支付
      • GetAbnormalPaymentList
      • CreateAbnormalPaymentRefund
    • Webhook
      • WcheckoutWebhook
  1. 快速开始

集成订单支付

本文将帮助您通过快速跑通 W Checkout 的订单支付流程,验证功能并确保集成正常运行。

1. 打开支付页面#

支付页可灵活接入,支持可选接入页,logo,主题色等
支持两种方式:
App 内嵌:在移动 App 中通过 WebView 打开 W Checkout 支付页。
浏览器访问:直接在浏览器中访问支付页链接。

2. 创建订单并传参#

客户系统需调用CreateCheckoutOrder生成订单,然后打开返回的 W Checkout 支付页:
参数名类型必填说明
orderNoString是客户系统生成的唯一订单编号,用于标识支付订单。
customerIdString是支付用户在客户系统中的唯一 ID。
merchantIdString是接受付款商户在客户系统中的唯一 ID。
orderAmountNumber是商品订单金额,单位为 USD。会按实时汇率转换为用户所选稳定币金额。
tokenString是用户选择支付的代币,如ETH_USDT。
expiredInNumber否支付订单过期时间(秒),从创建开始计时,超时后订单状态转为“超时”。

3. 支付页展示信息#

创建订单后,支付页将自动展示以下信息:
应付金额 (payableAmount)
根据订单金额与实时汇率换算后的稳定币金额。
收币地址 (depositAddress)
根据用户选择的链和稳定币自动生成的收款地址。

4. 用户支付#

用户可通过以下方式完成支付:
在支付页 连接钱包(如 MetaMask、TronLink 等)直接转账;
或者 复制收币地址,使用钱包手动转账。
W Checkout 会自动检测目标地址的链上收款交易,并更新订单状态。

5. 获取订单状态#

客户可通过以下两种方式获取订单支付结果:
Webhook 通知
配置 Webhook 地址后,系统会在订单状态变更时推送通知。
建议实现 幂等处理,确保重复通知不会影响业务逻辑。
查询接口
调用 GetCheckoutOrderInfo 接口可主动查询支付订单状态。
修改于 2025-09-26 06:30:51
上一页
集成准备
下一页
退款
Built with