globalpay_docs

1、接入流程

1、商务洽谈开户，沟通相关费率。 2、联系运营创建商户号、密钥、商户appId、产品编码、apiUrl。 3、当开发完成，双方进行联调测试，验证请求、上报等信息完整。

2、Md5 签名算法

1、所有参数按键对数组(key1=value1)进行升序排序(参数值为空时不参与签名) 2、按照 key1=value1&key2=value2 进行组合 3、加上商户秘钥 key1=value1&key2=value2…&key=商户秘钥 3、sign=md5(上一步组装待签名字的符串) 签名结果 32 位小写 4、签名密钥,请在商户后台->基础信息查看,或者询问我方客服

3、注意事项

3.1 接口相关

1、本文档中的所有接口，均采用 HTTP 标准通信协议，POST提交，请求和响应的 Content-type 均为 application/json，字符编码统一为 UTF-8。 2、金额单位为分。 3、请求接口的 IP 需要加白。 4、user_ip 尽量收集用户真实ip，确实没有就留空，不要使用127.0.0.1这种本地ip

3.2 回调相关

1、回调接收处理成功，请返回 success，系统将不再推送此订单信息，否则还会重复推送多次 2、在进行异步通知交互时，如果收到的应答不是 success ，会认为通知失败，会通过一定的策略定期重新发起通知。通知的间隔频率为：1m、1m、4m、10m、10m、1h、2h、6h、15h。 3、pay_notice_url通知地址如果为空，会视为商家不需要回调

4、代收下单接口

(下单 ip 需要联系我方加白) 下单地址 api_domain/api/v1/payApi/CreatePayInOrder 示例：http://host/api/v1/payApi/CreatePayInOrder

4.1 代收-下单请求参数

名称	类型	必填	描述
trade_no	int	true	商户号
app_id	int	true	商户 appId
pay_code	int	true	产品编码,联系我方运营获取
pay_method	string	true	支付方式参照支付方式字典
price	int	true	下单金额,单位:分 ,整数转元后不能有小数点
order_no	string	true	商户订单号
success_url	string	false	支付成功跳转 url
fail_url	string	false	支付失败跳转 url
pay_notice_url	string	false	支付成功通知 url
user_id	string	true	系统用户ID
user_ip	string	true	付款人 IP
attach	string	true	附加参数 json字符串付款人信息（建议填写）{”name”:”姓名”}
sign	string	true	签名结果,签名方法在文档顶部
timestamp	string	false	下单时间戳 10位时间戳单位S

代收-attach 附加参数字段说明

名称	类型	必填	描述
name	string	false	付款人姓名
account_no	string	false	付款人账号
account_type	string	false	账号类型:BANK(银行帐号)
bank_name	string	false	银行名称

代收-下单请求示例

{
  "trade_no": 10003,
  "order_no": "p7158412025RAprmNz7lR",
  "app_id": 10002,
  "pay_code": 0,
  "price": 10099,
  "pay_notice_url": "http://host/api/v1/mer/cbtest",
  "attach": "",
  "sign": "3d6dea05a7c08564911b9922e16455c2",
  "user_ip": "87.200.59.100",
  "success_url": "",
  "fail_url": "",
  "user_id": "2677343"
}

4.2 代收-下单响应

名称	类型	必填	描述
code	int	true	200:下单成功其他:下单失败
msg	string	true	失败原因
pay_url	string	false	付款链接
qr_code	string	false	pix 二维码字符串
order_no	string	true	商户订单号
dis_order_no	string	true	平台订单号
create_time	int	true	创建时间
pay_info	string	false	付款信息 json字符串例如：收款人账号account_no、收款人名字
sign	string	true	签名结果,签名方法在文档顶部

代收-下单响应示例

失败:

{
  "code": 1005,
  "msg": "Merchant not found",
  "sign": ""
}

成功:

{
  "code": 200,
  "msg": "",
  "sign": "b449b4b6907204a683ec6c50bff92b01",
  "order_no": "p7158412025J2dZjXLmz0",
  "dis_order_no": "2025071130770572062498816india1oushe",
  "create_time": 1752825512,
  "pay_url": "https://api.sunpayinr.net/checkout/scanqr/943543da169d4757a40bfa49b3eb83b5"
}

4.3 代收回传UTR –缅甸

10分钟内的订单有效 超过可能导致判定失败下单地址 api_domain/api/v1/payApi/BackUtr 示例：http://host/api/v1/payApi/BackUtr

代收回传UTR请求参数

名称	类型	必填	描述
trade_no	int	true	商户号
app_id	int	true	商户 appId
dis_order_no	string	true	平台订单号
utr	string	true	支付完成后获得的；请务必上传，否则可能无法计入支付！
sign	string	true	签名结果,签名方法在文档顶部

代收回传UTR响应参数

名称	类型	必填	描述
code	int	true	200:提交成功其他:下单失败
msg	string	true	失败原因
sign	string	true	签名结果,签名方法在文档顶部
data	string	false	附加信息 json字符串

代收回传UTR响应示例

{
  "code": 200,
  "msg": "",
  "sign": "b449b4b6907204a683ec6c50bff92b01"
}

5、代收回调通知 post/json

推送地址:商户下单传送的 pay_notice_url 回调 ip:call_back_server_ip ,请将我方 ip 加入回调白名单

5.1 代收回调-请求参数

名称	类型	必填	描述
trade_no	int	true	商户号
status	int	true	订单状态, 2.成功, 3.失败
order_no	string	true	商户订单号
dis_order_no	string	true	平台订单号
order_price	int	true	订单金额,单位:分
real_price	int	true	用户真实付款金额 ,单位:分
nti_time	int	false	发起通知时间
payer	string	false	JSON 字符串,付款人信息{“name”:”姓名”,”account”:”账号”,”bank”:”付款的用户银行编码”,”utr2”:”银行流水号”,”email”:”邮箱”,”phone”:”手机号”}，除示例字段外，当前参数会整合商户传递的attach里付款人信息相关字段
pay_info	string	false	付款信息 json字符串例如：收、付款原生信息、卡号、名字、银行等
create_time	int	true	创建时间
sign	string	true	签名结果,签名方法在文档顶部

代收回调-请求参数示例

{
  "trade_no": 10003,
  "status": 3,
  "order_no": "p71584120256SlWlKkymb",
  "dis_order_no": "2025071130460153942908928india1sKQbX",
  "order_price": 10099,
  "real_price": 10000,
  "payer": "{\"name\":\"姓名\",\"email\":\"邮箱\",\"phone\":\"手机号\"}",
  "nti_time": 1752826164,
  "create_time": 1752751502,
  "sign": "eba7f27e0f49581d8784294ef29f994d"
}

5.2 代收回调-响应说明

回调接收处理成功，请返回 success，系统将不再推送此订单信息，否则还会重复推送多次

6、代付下单接口

(下单 ip 需要联系我方加白) 下单地址 api_domain/api/v1/payApi/CreatePayOutOrder 示例：http://host/api/v1/payApi/CreatePayOutOrder

6.1 代付-请求参数

名称	类型	必填	描述
trade_no	int	true	商户号
order_no	string	true	商户订单号
app_id	int	true	商户 appId
pay_code	int	true	产品编码,联系我方运营获取
price	int	true	下单金额,单位:分 ,整数转元后不能有小数点
account_no	string	true	收款账号
account_type	string	true	账号类型:BANK(银行帐号)
account_name	string	true	姓名
bank_code	string	true	收款银行代码参照银行编码
pay_notice_url	string	false	代付成功通知 url
attach	string	false	附加参数 {“email”:”邮箱”,”phone”:”手机号”}
user_ip	string	true	收款用户 IP
sign	string	true	签名结果,签名方法在文档顶部
timestamp	string	false	下单时间戳 10位时间戳单位S

代付-请求参数示例

{
  "trade_no": 10003,
  "order_no": "p7158412025MsJydJqT7b",
  "app_id": 10002,
  "pay_code": 1,
  "price": 10001,
  "pay_notice_url": "http://host/api/v1/mer/cbtest",
  "attach": "",
  "sign": "12f74d71fa929087af79b5083567c453",
  "user_ip": "87.200.59.100",
  "account_type": "PHONE",
  "account_no": "123456789",
  "account_name": "test",
  "bank_code": "PKREAYPAISA"
}

6.2 代付-下单响应

名称	类型	必填	描述
code	int	true	200:下单成功其他:下单失败
msg	string	true	失败原因
dis_order_no	string	true	平台订单号
order_no	string	true	商户订单号
status	int	true	订单状态 2.代付成功, 3.代付失败, 7.驳回 9.冲正 10:处理中
create_time	int	true	创建时间
sign	string	true	签名结果,签名方法在文档顶部

代付-下单响应示例

失败:

{
  "code": 1005,
  "msg": "Merchant not found",
  "sign": ""
}

成功:

{
  "code": 200,
  "msg": "",
  "sign": "d3ec1fa0f45bc44218d5fb63bb1beb61",
  "order_no": "p7158412025MsJydJqT7b",
  "dis_order_no": "2025071130776296733810688india1Dhr7H",
  "create_time": 1752826877,
  "status": 10
}

7、代付回调通知

推送地址:商户下单传送的 pay_notice_url 回调 ip:call_back_server_ip ,请将我方 ip 加入回调白名单

7.1 代付回调请求参数

名称	类型	必填	描述
trade_no	int	true	商户号
order_no	string	true	商户订单号
dis_order_no	string	true	平台订单号
order_price	int	true	订单金额,单位:分
fee	int	false	订单手续费 ,单位:分
status	int	true	订单状态, 2.代付成功, 3.代付失败, 7.驳回 9.冲正
pay_info	string	false	付款信息 json字符串例如：收、付款原生信息、卡号、名字、银行等
remark	string	false	失败原因
create_time	int	true	创建时间
sign	string	true	签名结果,签名方法在文档顶部
nti_time	int	true	发起通知时间

代付回调请求示例

{
  "trade_no": 10003,
  "status": 3,
  "order_price": 10000,
  "order_no": "p71584120257igU8n8FII",
  "dis_order_no": "2025071130700746140950528india15rLVI",
  "nti_time": 1752808888,
  "create_time": 1752808865,
  "sign": "746140950528indi"
}

7.2 代付回调响应说明

回调接收处理成功，请返回 success，系统将不再推送此订单信息，否则还会重复推送多次

8、查询订单接口 (代收代付共用)

(请求 ip 需要联系我方加白) 查询地址: api_domain/api/v1/payApi/QueryOrder

8.1 查询请求参数

名称	类型	必填	描述
order_type	string	true	pay_out:代付,pay_in:代收
trade_no	int	true	商户号
app_id	int	true	商户 appId
dis_order_no	string	true	平台订单号
sign	string	true	签名结果,签名方法在文档顶部

查询请求示例

{
  "order_type": "pay_in",
  "trade_no": 165,
  "app_id": 165,
  "dis_order_no": "p7158277185f96603047656571",
  "sign": "db3406277185f9660b3b928d6adc7bc4"
}

8.2 查询响应

名称	类型	必填	描述
code	int	true	200:查询成功其他:失败
msg	string	true	查询失败原因
trade_no	int	true	商户号
real_price	int	true	真实付款金额 ,单位:分
status	int	true	订单状态, 1.未支付, 2.成功, 3.失败 , 7.驳回 9.冲正 10:处理中
success_time	int	true	成功时间戳
order_no	string	true	商户订单号
dis_order_no	string	true	平台订单号
remark	string	true	代付失败原因
fee	int	false	订单手续费 ,单位:分
create_time	int	true	创建时间
payer	string	false	JSON 字符串,付款人信息{“account_name”:”姓名”,”account_type”:”账号类型”,”account_no”:”账号”}
pay_info	string	false	收、付款信息 json字符串例如：收、付款原生信息、卡号、名字、银行等
sign	string	true	签名结果,签名方法在文档顶部
utr2	string	false	银行订单号

查询响应示例

失败:

{
  "code": 1017,
  "msg": "订单不存在"
}

成功:

{
  "code": 200,
  "msg": "",
  "trade_no": 10003,
  "real_price": 10000,
  "status": 3,
  "success_time": 0,
  "order_no": "p7158412025sdSrCeT94T",
  "dis_order_no": "35264004nh2lpi80400india1j5x",
  "utr2": "12347584513",
  "remark": "",
  "otherOrder": [
  ],
  "create_time": 1776337862,
  "payer": "{\"bank_code\":\"WavePay_MMK\",\"bank_name\":\"WavePay\"}",
  "sign": "04fced22db3308031e4a63392d5fcc64",
  "pay_info": "{\"account_no\":\"09682555313\",\"name\":\"Shauk+Mi\"}"
}

9、代付余额查询接口

(请求 ip 需要联系我方加白) 地址: api_domain/api/v1/payApi/QueryBalance

9.1 余额请求参数

名称	类型	必填	描述
trade_no	int	true	商户号
app_id	int	true	商户 appid
sign	string	true	签名结果,签名方法在文档顶部

余额请求示例

{
  "trade_no": 165,
  "app_id": 281,
  "sign": "db3406277185f9660b3b928d6adc115"
}

9.2 余额响应

名称	类型	必填	描述
code	int	true	200:查询成功其他:失败
msg	string	true	失败原因
balance	int	true	余额,单位:分
balance_frozen	int	false	冻结余额,单位:分
sign	string	true	签名结果,签名方法在文档顶部

余额响应示例

失败:

{
  "code": 10001,
  "msg": "商户不存在"
}

成功:

{
  "code": 200,
  "msg": "success",
  "balance": 10000,
  "balance_frozen": 1000,
  "sign": "db3406277185f9660b3b928d6adc7bc4"
}

10、付款凭证查询接口

(请求 ip 需要联系我方加白) 地址: api_domain/api/v1/payApi/QueryCertificate

10.1 付款凭证请求参数

名称	类型	必填	描述
trade_no	int	true	商户号
app_id	int	true	商户 appid
order_no	string	false	商户订单号与dis_order_no二选一
dis_order_no	string	false	平台订单号与order_no二选一
sign	string	true	签名结果,签名方法在文档顶部

付款凭证请求示例

{
    "trade_no": 10003,
    "app_id": 10003,
    "order_no": "",
    "dis_order_no": "35011C02gljuf6k0800india1lVY",
    "sign": "3969f17cd1a551769f85967d0a05b7b6"
}

10.2 付款凭证响应参数

名称	类型	必填	描述
code	int	true	200:响应成功其他:失败
msg	string	true	失败原因
img_link	string	false	凭证链接
img_base	string	false	凭证生成的64码
sign	string	true	签名结果,签名方法在文档顶部

付款凭证响应示例没有付款凭证

{
"code":200,
"msg":"No payment voucher available at the moment",
"sign": "",
"img_link": "",
"img_base": ""
}

有付款凭证

{
"code": 200,
"msg": "",
"sign": "3969f17cd1a551769f85967d0a05b7b6",
"img_link": "http://dsggfgdsf.djdj?ddd=snn",
"img_base": "data:image/png;base64,hfhshdhfhfh"
}

11、支付方式代收字段 pay_method

字段	国家	值	描述
pay_method	缅甸	KBZpay_MMK	KBZpay
pay_method	缅甸	WavePay_MMK	WavePay

12、银行编码

缅甸银行编码

字段名称	编码	说明
bank_code	KBZpay_MMK	KBZpay
bank_code	WavePay_MMK	WavePay

13、错误码

状态码	描述
200	成功
1000	内部错误
1001	ip不在商户ip白名单
1002	参数错误
1003	签名错误
1004	当前商户暂未开放该接口（联系运营核实:商户或App(不存在	已关闭	支付产品未配置)）
1005	商户不存在
1006	当前用户ip在黑名单中
1007	当前用户在黑名单中
1008	商户App不存在
1009	支付产品不存在
1010	支付渠道不存在
1011	支付通道暂未开发完成，暂时不开放
1012	支付通道异常，请稍后再试
1013	当前单量过大，请稍后再试
1014	订单号重复
1015	app余额不足
1016	同一用户频繁下单，请稍后再试
1017	订单记录不存在
1018	当前金额不支持
1019	当前app所在国家暂未开通支付下单
1020	当前app所在国家暂未开通代付下单
1021	失败
1036	接口暂未开放
1037	不支持该货币
1038	代收回传utr异常
9999	其他错误
3000	系统升级维护中，暂停下单，请稍后尝试

15、代收收银台接口

地址: /api/v1/cashApi/CashIn.html 请求方式: GET

参数:

名称	类型	必填	描述
app_id	string	true	商户app_id
order_no	string	true	商户订单号
amount	string	true	商户金额单位元
notice_url	string	false	异步通知地址

示例

/api/v1/cashApi/CashIn.html?app_id=&order_no=&amount=&notice_url=