TuitionPay版本 1.0.0

创建国内银行转账订单(仅用于跨境缴学费)

PUThttps://pay.globepay.co/api/v1.0/zl_gateway/partners/{partner_code}/order/{order_id}

该API为跨境学费汇款提供了一个集成接口。它是专门为学生学费支付场景设计的。学生或付款人提交订单详细信息、汇款人和实际付款人的身份信息,以及录取通知书。根据这些信息,系统将生成汇款所需的指定收款账户和参考代码。
由于合规和外汇法规,需要提交录取通知书和有效身份证件,以确保交易的真实性和合法性。

字段描述
Accept

application/json

Content-Type

application/json

Path Variable

字段类型描述
partner_codeString

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

order_idString

必填,商户支付订单号(建议长度8-25位),要求同一商户唯一

JSON字段

字段类型描述
descriptionString

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

priceint

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

payerNameString

必填,付款人姓名

payerPhoneString

必填,付款人的电话号码

payerIdCardString

必填,付款人的身份证号码

payerUrlString

必填,付款人身份证正面图片

payerBackUrlString

必填,付款人身份证背面图片

realPayerNameString

必填,实际付款人姓名(如果与付款人不同)

emergencyPhoneString

必填,紧急联系电话(必须是国内电话)

realPayerIdCardString

必填,实际付款人的身份证号码

realPayerUrlString

必填,实际付款人身份证正面图片

realPayerBackUrlString

必填,实际付款人身份证背面图片

relationshipString

必填,关系:01-父母;02-其他;03-自己

offerUrlString

必填,录取通知书文件URL

remittanceAmtString

必填,实际外币汇款金额

Query Params

字段类型描述
timeLong

必填,UTC毫秒时间戳

nonce_strString

必填,随机字符串

signString

必填,签名

Success 200

字段类型描述
referenceString

付款参考。学生在转账时必须包括在内

amountString

实际需要支付的金额

order_idString

GlobePay订单ID,这也是微信订单ID。支付的最终订单ID可能与此不同。

accountNameString

收款账户名称

accountNoString

收款账号

currencyString

货币

错误码

名称描述
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

本页目录