业务字段说明
场景代码 (scenarioCode)
商户需根据不同的业务场景在统一支付接口选择对应的scenarioCode
填写。
Online Payments
参数 | 说明 |
---|---|
创建QR Code支付单 | QR Code订单适用于PC及手机浏览器进行支付。用户使用微信和支付宝扫码后即可支付。 支付方式
|
创建银联/支付宝Web订单 | 用于PC端支付宝和银联支付,创建订单后跳转到返回的 支付方式使用 |
创建JSAPI订单 | JSAPI适用于在微信或支付宝APP内打开的网页进行支付,用户下单后跳转至AlphaPay订单页,并拉起微信或者支付宝内置收银台完成支付。 支付方式使用 |
创建Native JSAPI订单 | 使用Native JSAPI需要完成主体认证,并需要完成 支付方式获得 |
创建H5订单 | 注意:微信H5支付需额外申请 支付方式使用 |
创建SDK订单 | 用于移动端APP调用微信/支付宝/银联SDK支付,调用API创建订单,得到微信/支付宝/银联SDK调用参数,将参数传递给SDK拉起微信/支付宝/银联支付,并由微信/支付宝/银联客户端直接返回支付结果。强烈建议获得支付结果后再调用AlphaPay订单查询API确认完成支付后再进行后续流程,避免因超时自动撤单导致资金损失。 支付方式获得 点击下载银联SDK,Demo和使用指南:Android,IOS。把获得的 |
创建小程序订单 | 接入微信小程序需完成海外主体认证,并且认证主体需要与在AlphaPay开通的商户主体一致。 用于小程序中发起支付,创建订单后返回小程序支付所需参数,该接口支持微信、支付宝小程序。 支付方式获得 |
信用卡支付CREDIT_CARD | 商户网站接入信用卡支付方式,用户输入卡号、有效期、CVV等信息后完成支付。 |
In-store Payments
参数 | 说明 |
---|---|
创建线下QR Code支付单 - 商家被扫 | 线下QRCode支付用于对接无扫码设备的收银终端,下单后得到二维码地址,自行生成二维码图片后展示在收银终端屏幕上,并由用户使用对应支付客户端进行扫码支付。 支付方式客人使用微信、支付宝移动客户扫描生成的二维码进入AlphaPay收银台 |
创建线下支付订单 - 商家主扫 | 线下支付订单接口用于带有扫码设备的收银终端进行对接,商户输入金额后要求客户出示支付码,用扫码枪扫码后将扫码内容和金额一并提交并完成支付操作。 线下支付订单接口现已兼容微信、支付宝和银联云闪付。 支付方式商家使用收银终端扫码获取的客人付款码完成支付 |
付款状态 (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
,则需要调用查询接口确认支付结果状态。