业务字段说明

场景代码 (scenarioCode)

商户需根据不同的业务场景在统一支付接口选择对应的scenarioCode填写。

Online Payments

参数 说明

创建QR Code支付单ONLINE_QRCODE

QR Code订单适用于PC及手机浏览器进行支付。用户使用微信和支付宝扫码后即可支付。

支付方式
  1. 在商户页面生成二维码支付,使用
    • paymentQRImage: Base64封装的二维码图片,可直接作为img的src属性;
    • paymentUrl: 支付码字符串,商户可以据此自行生成二维码。
  2. 使用payUrl跳转到AlphaPay收银台。

创建银联/支付宝Web订单ONLINE_WEB

用于PC端支付宝和银联支付,创建订单后跳转到返回的payUrl(需附加redirect参数),随后进入银联/支付宝支付页面完成支付,该接口现仅支持银联和支付宝。

支付方式

使用payUrl跳转到银联/支付宝收银台

创建JSAPI订单JSAPI

JSAPI适用于在微信或支付宝APP内打开的网页进行支付,用户下单后跳转至AlphaPay订单页,并拉起微信或者支付宝内置收银台完成支付。

支付方式

使用payUrl跳转到AlphaPay收银台。

创建Native JSAPI订单NATIVE_JSAPI

使用Native JSAPI需要完成主体认证,并需要完成appid绑定。通过AlphaPay平台使用Native JSAPI创建订单获得参数后,即可通过微信/支付宝官方的JSAPI拉起支付。

支付方式

获得sdkParams之后,将参数传入微信、支付宝浏览器内置的JSBridge拉起支付,具体接入可参考:微信接入文档支付宝接入文档

创建H5订单ONLINE_WAP

注意:微信H5支付需额外申请
H5支付适用场景为移动端App或者手机自带浏览器进行支付,用户下单后浏览器跳转至微信/银联/支付宝支付页面并自动拉起相应客户端完成支付。

支付方式

使用payUrl跳转到AlphaPay收银台。

创建SDK订单APP

用于移动端APP调用微信/支付宝/银联SDK支付,调用API创建订单,得到微信/支付宝/银联SDK调用参数,将参数传递给SDK拉起微信/支付宝/银联支付,并由微信/支付宝/银联客户端直接返回支付结果。强烈建议获得支付结果后再调用AlphaPay订单查询API确认完成支付后再进行后续流程,避免因超时自动撤单导致资金损失。

支付方式

获得sdkParams之后,将参数传递给SDK拉起微信/支付宝支付,并由微信/支付宝客户端直接返回支付结果。

点击下载银联SDK,Demo和使用指南:AndroidIOS。把获得的sdkParams作为tn(交易码)传入UPPayAssistEx.startPay(activity, null, null, tn, serverMode)拉起支付。

创建小程序订单MINI_APP

接入微信小程序需完成海外主体认证,并且认证主体需要与在AlphaPay开通的商户主体一致。 用于小程序中发起支付,创建订单后返回小程序支付所需参数,该接口支持微信、支付宝小程序。

支付方式

获得sdkParams之后,使用参数接入微信小程序的支付,具体接入可参考以下文档: 微信小程序接入文档支付宝小程序接入文档

信用卡支付CREDIT_CARD商户网站接入信用卡支付方式,用户输入卡号、有效期、CVV等信息后完成支付。

In-store Payments

参数 说明

创建线下QR Code支付单 - 商家被扫OFFLINE_QRCODE

线下QRCode支付用于对接无扫码设备的收银终端,下单后得到二维码地址,自行生成二维码图片后展示在收银终端屏幕上,并由用户使用对应支付客户端进行扫码支付。

支付方式

客人使用微信、支付宝移动客户扫描生成的二维码进入AlphaPay收银台

创建线下支付订单 - 商家主扫OFFLINE

线下支付订单接口用于带有扫码设备的收银终端进行对接,商户输入金额后要求客户出示支付码,用扫码枪扫码后将扫码内容和金额一并提交并完成支付操作。 线下支付订单接口现已兼容微信、支付宝和银联云闪付。

支付方式

商家使用收银终端扫码获取的客人付款码完成支付

付款状态 (paymentStatus)

查询订单时返回的订单付款状态

参数 说明
PAYMENT_IN_PROCESS等待支付
CLOSED已关闭
FAILED订单创建失败、支付失败
SUCCESS支付成功
PARTIAL_REFUND部分退款
FULL_REFUND全额退款

退款状态 (refundStatus)

查询退款订单时返回的订单退款状态

参数 说明
REFUND_IN_PROCESS退款提交中
SUCCESS退款提交成功且退款成功
FAILED退款提交失败或退款失败

业务结果码 (resultCode)

业务处理结果的描述代码

参数 说明
PAYMENT_IN_PROCESS订单正在处理中
ORDER_MISMATCH订单号与商户不匹配
ORDER_PAID订单已支付
SYSTEMERROR系统内部异常
INVALID_MERCHANT_CODE商户编码不合法或没有对应商户
SIGN_TIMEOUT签名超时,time字段与服务器时间相差超过5分钟
INVALID_SIGN签名错误
PARAM_INVALID参数不符合要求,具体细节可参考resultMessage字段
INVALID_METHOD_TYPE不合法的支付渠道名称,请检查大小写
EXIST_PROCESSING_REFUND该笔订单有退款申请正在处理,请稍候再试
REFUND_VALID_DATE_EXCEED订单的退款时间已到期,最长允许一年
REFUND_NEED_REVIEW您的退款申请已提交,请等待系统审核。联系客服 1-855-937-7888
INVALID_REFUND_AMOUNT退款金额错误,请修改后重试
REFUND_NOT_ENOUGH_BALANCE您没有足够的未结算余额完成退款,如有疑问请与AlphaPay联系 1-855-937-7888
FULL_REFUND_COMPLETED该笔订单已完成全额退款
INVALID_PAYMENT_CODE付款码有误

业务结果状态 (resultStatus)

业务结果状态,支持的值:S F U

  • S:接口调用成功。
  • F:接口调用失败,resultMessage会有详细的错误信息描述,可能是商户也可能是平台的错误。
  • U:业务结果未知或处理中间状态。比如提交支付单后得到 PAYMENT_IN_PROCESS,则需要调用查询接口确认支付结果状态。