文档说明

接入前准备

商户在开始技术集成前,需要先跟AlphaPay签订相关产品的合同。如需帮助,请联系AlphaPay商务团队
在商户后台生成用于签名的RSA秘钥,详见签名算法,配置完成后即可开发测试。

适用货币

CAD USD

API 域名

加币:https://openapi.alphapay.ca
美金:https://openapi.alphapay.com

适用于支付场景

渠道区分

根据场景代码(scenarioCode)分为Online和Offline两个渠道,为避免混淆在此区分:

  • Online渠道:包含 ONLINE_QRCODE ONLINE_WEB JSAPI NATIVE_JSAPI ONLINE_WAP APP MINI_APP CREDIT_CARD
  • Offline渠道:包含 OFFLINE_QRCODE OFFLINE

相似场景代码注意区别:

  • JSAPI/NATIVE_JSAPI 是指在微信、支付宝客户端内访问的页面调起支付。ONLINE_WAP是指在移动设备任意浏览器或App的WebView调起支付。
  • ONLINE_WEB会跳转到支付宝或银联官方收银台,用户选择登陆账号或用客户端扫码完成支付。ONLINE_QRCODE是指商户自行创建二维码后,用户使用支付宝或微信扫码完成支付。

业务规则

  • 所有支付订单都由统一支付接口发起,商户需根据不同的业务场景传入对应的scenarioCode;
  • ONLINE_QRCODE 订单创建后会直接返回用于生成二维码的链接paymentUrl,base64编码的二维码图片paymentQRImage和AlphaPay收银台链接payUrl
  • 每次请求都需要生成新签名;
  • 商户需要在创建订单后使用订单查询接口轮询订单状态,直到订单被支付或过期;
  • 订单支付有效期为5分钟,订单有效期可以在商户后台修改:设置 > 支付设置 > 订单过期时间;
  • 创建支付订单和退款订单时需保证订单号的唯一性;
  • 所有金额数字均以货币最小面值为单位,以CAD为例,100表示1.00CAD