RetailPay版本 1.0.2

创建线下QRCode支付单

PUThttps://pay.globepay.co/api/v1.0/retail_qrcode/partners/{partner_code}/orders/{order_id}

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

货币类型如果是CNY,注意通过汇率转换后不得低于0.01GBP,否则订单可以创建成功,但支付时会报金额不合法错误

字段描述
Accept

application/json

Content-Type

application/json

Path Variable

字段类型描述
partner_codeString

必填,商户编码,由4-6位大写字母或数字构成

order_idString

必填,商户支付订单号,要求同一商户唯一

JSON字段

字段类型描述
descriptionString

必填,订单标题(最大长度128字符,超出自动截取)

priceint

必填,金额,单位为货币最小单位,GBP为例,100表示GBP 1.00,CNY为例,100表示CNY 1.00

currencyString

币种代码

默认值: GBP

允许值: GBP, CNY

device_idString

必填,设备ID

notify_urlString

支付通知url,详见支付通知api,不填则不会推送支付通知

operatorString

操作人员标识

Query Params

字段类型描述
timeLong

必填,UTC毫秒时间戳

nonce_strString

必填,随机字符串

signString

必填,签名

Success 200

字段类型描述
return_codeString

执行结果

result_codeString

SUCCESS表示创建订单成功,EXISTS表示订单已存在

partner_codeString

商户编码

full_nameString

商户注册全名

partner_nameString

商户名称

order_idString

GlobePay订单ID,同时也是微信订单ID,最终支付成功的订单ID可能不同

partner_order_idString

商户订单ID

code_urlString

支付码字符串,商户可以据此自行生产二维码

错误码

名称描述
ORDER_MISMATCH

订单号与商户不匹配

ORDER_PAID

订单已支付

SYSTEMERROR

系统内部异常

INVALID_SHORT_ID

商户编码不合法或没有对应商户

SIGN_TIMEOUT

签名超时,time字段与服务器时间相差超过5分钟

INVALID_SIGN

签名错误

PARAM_INVALID

参数不符合要求,具体细节可参考return_msg字段

NOT_PERMITTED

未开通网关支付权限

INVALID_CHANNEL

不合法的支付渠道名称,请检查大小写

ERROR

名称描述
return_code

Error Code

return_msg

Error Description

PCI DSS Compliant

安全与合规

  • PCI DSS符合支付卡行业数据安全标准
  • TLS 1.2+API 仅接受 TLS 1.2 / 1.3 加密连接
  • SHA-256每个 API 请求均须附带 SHA-256 签名

京ICP备18003250号-3

本页目录