RetailPay版本 1.0.2

创建线下支付订单

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

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

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

auth_codeString

必填,扫描用户微信客户端得到的支付码

notify_urlString

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

Query Params

字段类型描述
timeLong

必填,UTC毫秒时间戳

nonce_strString

必填,随机字符串

signString

必填,签名

Success 200

字段类型描述
return_codeString

执行结果

result_codeString
  • PAYING:等待支付
  • CREATE_FAIL:订单创建失败
  • CLOSED:已关闭
  • PAY_FAIL:支付失败
  • PAY_SUCCESS:支付成功
order_idString

GlobePay订单ID,同时也是微信订单ID

partner_order_idString

商户订单ID

total_feeint

订单金额,单位是货币最小面值单位

real_feeint

实际支付金额,单位是货币最小面值单位(目前等于订单金额,为卡券预留)

pay_timeString

支付时间(yyyy-MM-dd HH:mm:ss,GMT+8)

create_timeString

订单创建时间(最新订单为准)(yyyy-MM-dd HH:mm:ss,GMT+8)

currencyString

币种,通常为GBP

channelString

支付渠道 Alipay|支付宝、Wechat|微信

错误码

名称描述
ORDER_MISMATCH

订单号与商户不匹配

ORDER_PAID

订单已支付

AUTHCODEEXPIRE

二维码已过期

NOTENOUGH

余额不足

NOTSUPORTCARD

不支持卡类型

AUTH_CODE_ERROR

二维码被重复提交

AUTH_CODE_INVALID

不是微信支付二维码

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

本页目录