文档说明

接入前准备

商户在开始技术集成前，需要先跟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。