TuitionPay版本 1.0.0
创建国内银行转账订单(仅用于跨境缴学费)
PUT
https://pay.globepay.co/api/v1.0/zl_gateway/partners/{partner_code}/order/{order_id}该API为跨境学费汇款提供了一个集成接口。它是专门为学生学费支付场景设计的。学生或付款人提交订单详细信息、汇款人和实际付款人的身份信息,以及录取通知书。根据这些信息,系统将生成汇款所需的指定收款账户和参考代码。
由于合规和外汇法规,需要提交录取通知书和有效身份证件,以确保交易的真实性和合法性。
Header
| 字段 | 描述 |
|---|---|
Accept | application/json |
Content-Type | application/json |
Path Variable
| 字段 | 类型 | 描述 |
|---|---|---|
partner_code | String | 必填,商户编码,由4-6位大写字母或数字构成 |
order_id | String | 必填,商户支付订单号(建议长度8-25位),要求同一商户唯一 |
JSON字段
| 字段 | 类型 | 描述 |
|---|---|---|
description | String | 必填,订单标题(最大长度128字符,超出自动截取) |
price | int | 必填,金额,单位为货币最小单位,GBP为例,100表示GBP 1.00 |
payerName | String | 必填,付款人姓名 |
payerPhone | String | 必填,付款人的电话号码 |
payerIdCard | String | 必填,付款人的身份证号码 |
payerUrl | String | 必填,付款人身份证正面图片 |
payerBackUrl | String | 必填,付款人身份证背面图片 |
realPayerName | String | 必填,实际付款人姓名(如果与付款人不同) |
emergencyPhone | String | 必填,紧急联系电话(必须是国内电话) |
realPayerIdCard | String | 必填,实际付款人的身份证号码 |
realPayerUrl | String | 必填,实际付款人身份证正面图片 |
realPayerBackUrl | String | 必填,实际付款人身份证背面图片 |
relationship | String | 必填,关系:01-父母;02-其他;03-自己 |
offerUrl | String | 必填,录取通知书文件URL |
remittanceAmt | String | 必填,实际外币汇款金额 |
Query Params
| 字段 | 类型 | 描述 |
|---|---|---|
time | Long | 必填,UTC毫秒时间戳 |
nonce_str | String | 必填,随机字符串 |
sign | String | 必填,签名 |
Success 200
| 字段 | 类型 | 描述 |
|---|---|---|
reference | String | 付款参考。学生在转账时必须包括在内 |
amount | String | 实际需要支付的金额 |
order_id | String | GlobePay订单ID,这也是微信订单ID。支付的最终订单ID可能与此不同。 |
accountName | String | 收款账户名称 |
accountNo | String | 收款账号 |
currency | String | 货币 |
错误码
| 名称 | 描述 |
|---|---|
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 |
