# Mangopay接口文档

本站地址：https://doc.mango-pay.net (opens new window)

# 本站内容介绍

man-gopay支付文档

商户系统

1.商户账号申请：

联系平台运营人员获取

2.商户系统网址

https://merchant.mango-pay.net (opens new window)

3.商户登录系统

账户：联系平台运营人员提供

注：首次登陆后记得修改初始密码哦！！！

# 数字签名规范

# 商户测试账号基本信息

测试商户基本信息：

"商户名":TestingMerchants
"商户编号":861100000037709
"商户秘钥":9E7159108078E210859118D36F848B34
"平台公钥":MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCmKYf2CA+Tzh5uWQ2NZvlbCelf95JOOysXDWqHYbT53qHYRp6rKp1wOH+EHr2ZfRvrCrXfTM/ubFhchZrsIpRGtwgZqHeRodlM9Y6rtyKHznoBdRTC78zE9aIuFYv4f5lK0pjdt7xpXw4I1RSaDP19N5RpeKf7ALsxYcpxJ6wAMwIDAQAB

1
2
3
4

测试商户RSA公钥：

MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDUNqs5eHa95WiHCrwbUmPHtZuHn8g9vuoPEai9DXBW8C/2KRzVf7Ea4C3lD9i/zRoLNE2YkBbT+fWE/bU5or4Z2uxrRrypfnhaQVj4D1Dc2jzW4Af1X1pD/KXJ/1wdgDP4NXAu/TldOZHyitK9ZIrV/bXfxuoCRgmUjVL3u0YuBQIDAQAB

测试商户RSA私钥：

MIICdgIBADANBgkqhkiG9w0BAQEFAASCAmAwggJcAgEAAoGBANQ2qzl4dr3laIcKvBtSY8e1m4efyD2+6g8RqL0NcFbwL/YpHNV/sRrgLeUP2L/NGgs0TZiQFtP59YT9tTmivhna7GtGvKl+eFpBWPgPUNzaPNbgB/VfWkP8pcn/XB2AM/g1cC79OV05kfKK0r1kitX9td/G6gJGCZSNUve7Ri4FAgMBAAECgYAadH4/+d6DqdewDgyJM2ow+VjcPXUPDX/MRR1OBCDfFa5E97cafoKroQrXpXQV5RG8F9ccj8novx52Z9JxzvH3uQGXRcYo0bqWjM2ZB0gSai3ijFgLAsn3uNmHWMI5ifq7SAvegOhnZ8L2oT7DbReTnm/kIjHVE8YfLhv2tfPeeQJBAPOII9Qs3rbaog185PXe7PJIHf4PwIEjEwIY+KsVaFzMykZ4haS20nYX1DIU7DX5WjHHC69ztLoJ/keIu7EIee8CQQDfFA4QMLSpTZ7nVkh3GYWM06xXhEpWUe9G10LwFUDBweI0rmKRoo5Ej+ozOOBqMnTG/1rjctD5gUfN/rmRNdtLAkEAsS/1eZOn+3y5eXzMjcPDvEgSYl6NnqepVdZbXwb1ZsetyHY6LmzCVh/iSQoGDwM8x4jeDKrv7IgG1X87qIPVSwJAU+pKZAK+YxWk2ecWOV8rYs9ZfE5yXEhUFzTwpDmKc5iIjEKxJ5GbrOTqN7yEhs5WKWlzei39uG3OYgoZKiu1QwJAHQTtG5ENV0yj1tj68gNzAtTl+JV22W+SaBwShZKIF7VD4qvAi44gKh26VzQLUGpqkEWmhflVwtnJQa0+0Niskg==

所有接口的签名规范：

将所有参数按照字段名的 ASCII 码(字典序)从小到大排序后使用 QueryString的格式（即key1=value1&key2=value2…）拼接成签名串, 空参数和sign不参与签名

注意以下重要规定：

参数名ASCII码从小到大排序（字典序）；
使用 QueryString 的格式（即key1=value1&key2=value2…）拼接；
验证调用返回或支付中心主动通知签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验；
空值不参与签名；

# RSA公钥生成步骤规则参考

访问http://web.chacuo.net/netrsakeypair (opens new window) 点击生成密钥对,删除RSA生成格式->BEGIN RSA PRIVATE KEY和END PUBLIC KEY,即第一行和最后一行
密钥格式：生成密钥位数： 1024位(bit) 密钥格式： PKCS#8 输出格式： PEM/Base64
访问http://www.ab173.com/gongju/other/compress.php (opens new window) 将生成的公钥和私钥复制到压缩文本框中去除换行和空格
把公钥上传至商户后台,平台会使用该公钥进行解密并且验签。
私钥自己隐秘保存(加密用)

# Md5加密格式案例(案例只做参考)

1.所有查询接口和通知接口使用MD5加密，在签名串最后加上秘钥&key=key形成最终签名串

例:

加密前

busi_code=100303&ccy_no=INR&countryCode=IND&goods=goods&mer_no=xxx
&mer_order_no=1627975567581P05&notifyUrl=http://www.google.com
&order_amount=500.00&pageUrl=http://baidu.com&pemail=test@gmail.com
&phone=8696100462&pname=zhangsan&timeout_express=30m&key=xxx

1
2
3
4

加密后

16c17647ca9f4fa080cef02bd6a7a588

# RSA加密格式案例(案例只做参考)

1.支付、代付、补单接口使用RSA加密(密钥长度1024位,密钥格式PKCS#8方式)加密
2.使用工具类或者在线网址生成公钥和私钥,私钥自己保存,公钥上传至商户后台.使用私钥加密签名串
3.加密做base64转码再进行URL编码(只对sign值做url编码)
备注：不需要在最后面拼接&key=key

例:

加密前

busi_code=100303&ccy_no=INR&goods=test&mer_no=xxx&mer_order_no=testOrder1650441426386&
notifyUrl=http://www.google.com&order_amount=100&pageUrl=http://www.baidu.com&pemail
=test@mail.com&phone=9852146882&pname=Zhang San

1
2
3

加密后

hv_OoRZejna_3baya6wSRadYNvV718BQ_QLthR56OWkLx-4FrOKCawwM_4y33rcjpLM8
bwqr_mRYGMQ19PKKmBB5HABQXhBBZ76x2Dqyl77kRSOHlt3akG8mKGiq8p8etP-jS8va
2eHpLS96lTt-Kc5wcgrlFjFwZ1s8xlLa0NQOIlED1afGnLEsZRXyf0oyZY-NpOUDJYHG
us6aTfbfR5gd6Z-yQ8h4ELK8D_UNJTUQBVkxL4ffXI2KR2fGoWyaOjX6ZCXwgA9yg5Yk
p5whwtzckE0fQzZeFJPXKn_ad_tTGcdx5MGnKcm8I_vT39a8HjfQcT3VWskGDsNr5Tt8VA

1
2
3
4
5

# 加密算法工具类

访问https://core.mango-pay.net/download (opens new window)

# 支付类型编码

支付类型编码	支付类型说明
100303	印度代收

# 支付业务

# 支付下单

简要描述：

商户业务系统通过支付下单接口发起支付收款订单。

请求URL：

https://core.mango-pay.net/ty/orderPay (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	商户编号
2	mer_order_no	商户订单号	String	是	商户必须保证订单号唯一
3	pname	姓名	String	是	案例:zhang san(必须是字母),如没有可以固定上传
4	pemail	邮箱	String	是	案例:test@gmail.com(需要符合邮箱格式),如没有可以固定上传
5	phone	手机号	String	是	案例:13122336688(纯数字,不需要加区号)
6	order_amount	交易金额	String	是	金额,两位小数
7	ccy_no	币种编码	String	是	币种编码例:INR:印度卢比,BRL:巴西币
8	busi_code	支付类型编码	String	是	100303 详情见：支付类型编码
9	notifyUrl	异步通知地址	String	是	支付成功后，平台主动通知商家系统，商家系统必须指定接收通知的地址。
10	pageUrl	支付成功，页面跳转地址	String	否	支付成功,页面跳转地址
11	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "mer_no": "xxx",
  "phone": "9852146882",
  "pname": "ZhangSan",
  "order_amount": "100",
  "sign": "hv_OoRZejna_3baya6wSRadYNvV718BQ_QLthR56OWkLx-4FrOKCawwM_4y33rcjpLM8bwqr_mRYGMQ19PKKmBB5HABQXhBBZ76x2Dqyl77kRSOHlt3akG8mKGiq8p8etP-jS8va2eHpLS96lTt-Kc5wcgrlFjFwZ1s8xlLa0NQOIlED1afGnLEsZRXyf0oyZY-NpOUDJYHGus6aTfbfR5gd6Z-yQ8h4ELK8D_UNJTUQBVkxL4ffXI2KR2fGoWyaOjX6ZCXwgA9yg5Ykp5whwtzckE0fQzZeFJPXKn_ad_tTGcdx5MGnKcm8I_vT39a8HjfQcT3VWskGDsNr5Tt8VA",
  "notifyUrl": "http://www.google.com",
  "pageUrl": "http://www.baidu.com",
  "ccy_no": "INR",
  "pemail": "test@mail.com",
  "busi_code": "100303",
  "mer_order_no": "testOrder1650441426386"
}

1
2
3
4
5
6
7
8
9
10
11
12
13

返回参数说明

序号	参数名	参数名称	类型	说明
1	mer_no	商户号	String	原样返回
2	mer_order_no	商户订单号	String	原样返回
3	order_amount	交易金额	String	原样返回
4	busi_code	支付类型编码	String	支付类型编码
5	notifyUrl	异步通知地址	String	原样返回
6	pageUrl	支付成功，页面跳转地址	String	原样返回
7	order_no	平台订单号	String	下单成功返回平台唯一订单号
8	order_time	订单时间	String	时间戳：(格式为yyyyMMddHHmmss 4位年+2位月+2位日+2位时+2位分+2位秒)
9	status	订单提交状态	String	成功：SUCCESS 失败：FAIL
10	order_data	支付链接	String	下单成功时有值
11	pname	下单人姓名	String	原路返回
12	pemail	下单人email姓名	String	原路返回
13	phone	手机号	String	原路返回
14	ccy_no	币种编码	String	原路返回
15	sign	数字签名	String	下单成功返回详见：数字签名规范
16	err_code	错误码	String	请求失败返回错误码
17	err_msg	错误信息	String	请求失败返回错误描述

返回参数示例

{
  "order_no": "2406240000000057242115043852",//平台订单号
  "mer_no": "861100000014282",
  "pname": "zhangsan",
  "sign": "ej-S5i5P75AX6y8Qavg9_xmdafT_VOEgtQAAizybVsUM3kIom1Ai_w9Stwvlb1WS9oiJ0s12_WuftE3TNh9qEACkd9T5Pd1VOIb-lgjCnjNsJU53W5ELK1Bi6D8DtyBGIVLnY_EqOHVuat6nxosnntBZibwoj4NKV4IxZAlbMQ6JgDs733-p_W_oN_RA7EIo-zlh7oVGBot_Xk7c2hOz442EfjZj_kmzo8m9t_UgcNMSPdlzOxlzH0hPLK1ARrSneIGMguVpfR4Y0lrjpqcjRV5Ser5kaX9yEf7753xBVPtcdKHszARMC4CPwv8YD73RqDRupyQTd_G-msIz7CFD1l4QtAnxlYB3H0t-gb0bIzPlgyDH-0r8KPSe0695guT2vhq2qVneQr_9RSyP1uY9EXZA3vIFFKAeyvqCGETATZdcHUfTle7BIb7QKYy_e3IFChFGYTeBf6Ny0_U5U6vJp7Y5zJ69gWNjtz_az-O8MRafQo8ayI0SzTHpRlYcOjiEPOqPQM5OBI8t6ZvpGFrx8FHT1kfZqpNdLQBkVWNXunlL5OBmpMeRbMrDHPbQ7FS4UlGB9GwCCH-iqwKVs7P3m_t1f9-YHNsr_hi31RftSI5OSUz6EbSkuufn-BDxEvVvK-GBontyI76r5PJrifhk8voO5IlFlQz6JbJYNQiVxlM",
  "order_time": "20240624115043",
  "pemail": "test@gmail.com",
  "phone": "6789322980",
  "order_data": "https://lucky.tatatapay.com/v1.0/api/payOrder?orderId=3202406241150444&sign=16CEE42F2B6BC4C558F10D5DDDCAD8DE",
  "order_amount": "800.00",
  "notifyUrl": "https://wb.babyforever.top/api/pay/notify",
  "pageUrl": "http://www.baidu.com",
  "ccy_no": "INR",
  "busi_code": "100303",
  "mer_order_no": "1111719201041754",
  "status": "SUCCESS"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# 支付查询

简要描述：

商户业务系统通过支付查询接口，查询支付收款订单，支付中心会返回订单最新的数据。

请求URL：

https://core.mango-pay.net/ty/orderQuery (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	商户编号
2	mer_order_no	商户订单号	String	否	商户订单号
3	order_no	平台订单号	String	否	平台订单号，（和商户订单号2选1，两个都传只会查平台订单号）
4	request_no	请求流水号	String	是	每次请求,请求流水号需要不同
5	request_time	请求时间	String	是	时间戳格式:( yyyyMMddHHmmss)
6	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "order_no": "2104060000001717561144728475",
  "mer_no": "xxx",
  "request_time": "20210406145308",
  "request_no": "1617695588427",
  "sign": "xxx",
  "mer_order_no": "1617695248072"
}

1
2
3
4
5
6
7
8

返回参数实例

序号	参数名	参数名称	类型	说明
1	mer_no	商户号	String	原样返回
2	mer_order_no	商户订单号	String	原样返回
3	order_amount	订单金额	String	订单金额
4	order_no	平台订单号	String	平台订单号
5	utr	utr	String	平台支付utr
6	pay_amount	实际支付金额	String	实际支付金额
7	order_time	订单时间	String	时间戳：(格式为yyyyMMddHHmmss 4位年+2位月+2位日+2位时+2位分+2位秒)
8	pay_time	支付时间	String	时间戳：(格式为yyyyMMddHHmmss 4位年+2位月+2位日+2位时+2位分+2位秒)
9	order_status	订单状态	String	UNPAY:待支付 SUCCESS:成功 FAIL:失败
10	order_err_code	订单错误码	String	错误码
11	order_err_msg	订单错误信息	String	错误描述
12	sign	数字签名	String	详见：数字签名规范
13	query_err_code	查询错误码	String	请求失败返回错误码
14	query_err_msg	查询错误信息	String	请求失败返回错误描述

返回参数示例

{
  "order_no": "2104060000001717561144728475",
  "mer_no": "xxx",
  "order_err_msg": "success",
  "request_no": "1617695588427",
  "query_status": "SUCCESS",
  "sign": "xxx",
  "order_time": "20210406144728",
  "order_status": "UNPAY",
  "order_err_code": "0",
  "request_time": "20210406145308",
  "order_amount": "100000.00",
  "mer_order_no": "1617695248072",
  "query_err_code": "000002",
  "query_err_msg": "orderQuery success"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# 支付补单

简要描述：

商户通过订单号与银行流水UTR进行补发通知。

请求URL：

https://core.mango-pay.net/ty/orderPayPatch (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	商户编号
2	mer_order_no	商户订单号	String	是	商户必须保证订单号唯一
3	utr	补单utr	String	是	补单utr
4	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "mer_no": "861100000033178",
  "utr": "154637893541",
  "sign": "907835048d3eecc672d5f600e08bce99",
  "mer_order_no": "1660283627634air"
}

1
2
3
4
5
6

返回参数说明

序号	参数名	参数名称	类型	说明
1	data	补单详情	String	status 为true时才有值,返回SUCCESS表示成功，其他提示信息表示补单失败
2	errCode	错误码	String	原样返回
3	errMsg	错误信息	String	原样返回
4	status	补单状态	Boolean	true,只代表接口请求成功,实际订单状态以异步通知为准

返回参数示例

{
  "data": "此订单支付状态成功,请核实!",
  "errCode": "",
  "errMsg": "",
  "status": true
}

1
2
3
4
5
6
7

# 查询utr

简要描述：

根据utr查询订单信息以及状态。

请求URL：

https://core.mango-pay.net/ty/queryOrderUtr (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	商户编号
2	utr	utr	String	是	订单utr
3	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "mer_no": "861100000033178",
  "utr": "306386329131",
  "sign": "907835048d3eecc672d5f600e08bce99",
}

1
2
3
4
5

返回参数说明

序号	参数名	参数名称	类型	说明
1	errCode	错误码	String	原样返回
2	errMsg	错误信息	String	原样返回
3	status	补单状态	Boolean	true,只代表接口请求成功,实际订单状态以异步通知为准
4	data	补单详情	String	status 为true时才有值

data：

序号	参数名	参数名称	类型	说明
1	amount	订单金额	String	订单金额
2	merchant_order_no	商户订单号	String	到账已核销情况下返回
3	utr_status	订单状态	String	utr状态例如： 1没有查到 2到账已核销 3到账未核销 4查到已使用(非当前商户)
4	resMsg	msg	String	提示信息

返回参数示例

{
    "data": {
        "utr_status": "2",
        "amount": "200.00",
        "merchant_order_no": "1111714109347357",
        "resMsg":"查询成功"
    },
    "errCode": "",
    "errMsg": "",
    "status": true
}

1
2
3
4
5
6
7
8
9
10
11

# 查询upi

简要描述：

查询近期使用upi地址。

请求URL：

https://core.mango-pay.net/ty/checkRecentUpi (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	商户编号
2	upi	upi	String	是	upi账号
3	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "mer_no": "861100000033178",
  "upi": "sdffga3131rp@sbi",
  "sign": "907835048d3eecc672d5f600e08bce99",
}

1
2
3
4
5

返回参数说明

序号	参数名	参数名称	类型	说明
1	errCode	错误码	String	原样返回
2	errMsg	错误信息	String	原样返回
3	status	补单状态	Boolean	true,只代表接口请求成功,实际订单状态以异步通知为准
4	data	补单详情	String	status 为true时才有值

data：

序号	参数名	参数名称	类型	说明
1	query_status	查询状态	String	SUCCESS 成功,FAIL 失败(表示是否是本平台近期的upi)
2	query_message	查询说明	String	查询upi的说明信息
3	errCode	错误码	String	原样返回
4	errMsg	错误信息	String	原样返回
5	status	补单状态	Boolean	true,只代表接口请求成功,实际订单状态以异步通知为准

返回参数示例

{
  "data": {
      "query_status": "SUCCESS",
      "query_message": "SUCCESS"
    },
    "errCode": "",
    "errMsg": "",
    "status": true
}

1
2
3
4
5
6
7
8
9

# 代付业务

# 单笔代付

简要描述：

商户业务系统通过支付查询接口，查询支付收款订单，支付中心会返回订单最新的数据。

请求URL：

https://settle.mango-pay.net/withdraw/singleOrder (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	平台分配的唯一商户编号
2	mer_order_no	商户订单号	String	是	商户订单号需要唯一,不能重复
3	acc_no	平收款账号	String	是	收款账号
4	acc_name	收款户名	String	是	收款姓名
5	ccy_no	币种	String	是	币种例:INR:印度卢比
6	order_amount	金额	String	是	卢比为单位,保留二位小数
7	bank_code	银行编码	String	是	印度代付类型,填UPI表示的是UPI代付,IMPS/BANK/PAYTM表示银行卡代付.
8	mobile_no	手机号	String	是	手机号
9	email	邮箱	String	是	邮箱
10	province	省份	String	是	印度银行卡代付需要填写(IFSC)
11	notifyUrl	回调地址	String	是	代付提交成功,有最终结果,均会向该地址发送回调
12	summary	备注	String	是	备注
13	sign	数字签名	String	是	详见：数字签名规范
14	identity_no	身份证号	String	否	巴西代付必须填写收款人税号(CPF)，相当于身份ID,11位或14位。
15	identity_type	证件类型	String	否	巴西PIX代付,需要填写,分为CPF, CNPJ, PHONE, EMAIL, EVP五种之一。

请求参数示例

{
  "summary": "summary",
  "bank_code": "BANK",
  "acc_name": "zhangsan",
  "mer_no": "xxx",
  "province": "PYTM0123456",
  "order_amount": "10",
  "mobile_no": "423524127",
  "email":"sdahdasdhajsd15616@gmail.com",
  "acc_no": "912523192592",
  "sign": "ADtr_JPO1WKUnhOSvfdkAPiLsHsXDbrjpIB0k9QCdGo90EvZzvNGJpLsr7INXXhnN_XmePCCFdNaqMoye0mbVYWbVfC_koEZ79mNtcssjeD2RshxdND7viU1VQWiZEs8rRYJL0wSIAsFxWw7T8nd8SDQwkHBun5wS_QS44GWKY4QAhjK6yVTsQfKx69YoDLyR-PdII9dwhk6MJxwpSIKURbOVbPFH6PEcLICpgY5JCXWp_Y5gi5zUP8Xf5R9AMYt3UCA6VfteL_Z_NXW8pPcYXLvf69yPPiIKZxt_dFPPhXZgx51Q2w_S1go63PlAPpszHnxyXLi4cgGK3WF6qVpmw",
  "notifyUrl": "http://www.google.com",
  "ccy_no": "INR",
  "mer_order_no": "testOrder1650535029326"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

返回错误说明

序号	参数名	参数名称	类型	说明
1	status	订单提交状态	String	仅表示订单受理状态非订单代付状态; SUCCESS：成功 FAIL:失败
2	err_code	错误码	String	错误码
3	err_msg	错误信息	String	错误描述

当status为SUCCESS时，以下参数才返回

序号	参数名	参数名称	类型	说明
1	mer_no	商户号	String	原样返回
2	mer_order_no	商户订单号	String	原样返回
3	order_no	平台订单号	String	订单金额
4	account_no	子账户号	String	原样返回
5	acc_no	实收款账号	String	原样返回
6	acc_name	收款户名	String	原样返回
7	ccy_no	币种	String	原样返回
8	order_amount	金额	String	原样返回
9	summary	摘要	String	原样返回

请求成功返回参数示例

{
    "summary": "代付测试",
    "order_no": "202406250000000088220161629375",
    "bank_code": "BANK",
    "mer_no": "861100000037709",
    "mobile_no": "6789322980",
    "sign": "iAekl4sq_ZvusA3oJI5CUhDsUWzpkMoHHkvQ5gc89qz96MFdD5CVq9AnzRtIXLcx8LvSmnOIxR9rjAbs5wIQA-zKvjf-lTRmsQsOGn8HWrMI-3AX4D7iCwXOgczrgo_HWQcggzW31xa3X-s2bY5DFea4a2HGy6xamQN-WfAU9fCT8PAFNkbZVMGdJ9kwdIta9E8C2u-X5l0GIkUQwNWRC7mpfIpZrq6cyOhZvXs-UQVZ5Mt-gXd7KKvIKDhr0KLo1agzmT0SP07r32XbfYize23SUH0FoF1fR4VF1mIb_NOb4QQ-h1K0XPbXZnYpoZw1e0JESYaF0H5abBpRusyjGitU-6xQybSH9exUiyj8wj6cqClComPBl0jx5RFiyb2hb4DhV4o2BUZ9UDa8OqZGM9fXIrNRvuptQm1c2R-JU9OOBYgnbBEX8Z3BciL6LcZlMm2i5qq8DeK4F0WTlDXrvpwlxNKjPuDo8fEwSFNc9aGbzRox6offYlRHIOtje-2jBePrmEJO4Lo2AJhYF3CBh0RSR8lNzcWunusQj3iv9Y1Utzpv9KGVn_h1AMj13M4K2v-9fY3nxwRQtjNk-N12DT98-iQAo7H3N5FR34iIadave-D7hBz8v3LBxD4Wr8FG4FHQc3mTRcoraIZk3xB4epIIpLW6pQgaQItGu2SElmY",
    "err_code": "999999",
    "err_msg": "This order is a test order",
    "account_no": "9051400000011797",
    "acc_name": "Neeraj Kapoor",
    "province": "ICIC0000087",
    "order_amount": "10.00",
    "acc_no": "008701535655",
    "notifyUrl": "https://wb.babyforever.top/api/pay/notify",
    "ccy_no": "INR",
    "mer_order_no": "5551719303386444",
    "email": "test@gmail.com",
    "status": "SUCCESS"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

# 代付订单查询

简要描述：

商户业务系统通过转账查询接口，查询转账付款订单，支付中心会返回订单最新的数据。

请求URL：

https://settle.mango-pay.net/withdraw/singleQuery (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	平台分配的唯一商户编号
2	mer_order_no	商户订单号	String	是	商户订单号需要唯一,不能重复
3	order_no	平台订单号	String	否	平台订单号
4	request_no	请求流水号	String	是	每次请求流水号唯一,不可重复
5	request_time	请求时间戳	String	是	时间戳:24小时制,每次请求需要当前时间：yyyyMMddHHmmss
6	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "order_no": "2104060000001717561144728475",
  "mer_no": "xxx",
  "request_time": "20210406145308",
  "request_no": "1617695588427",
  "sign": "xxx",
  "mer_order_no": "1617695248072"
}

1
2
3
4
5
6
7
8

返回错误说明

序号	参数名	参数名称	类型	说明
1	query_status	查询状态	String	SUCCESS 成功,FAIL 失败；只表示代表查询状态，不表示业务状态
2	query_err_code	查询错误码	String	错误描述信息
3	query_err_msg	查询错误信息	String	错误描述

query_status等于SUCCESS以下数据才返回

序号	参数名	参数名称	类型	说明
1	mer_no	商户号	String	原样返回
2	mer_order_no	商户订单号	String	原样返回
3	request_no	请求流水号	String	原样返回
4	request_time	请求时间戳	String	原样返回
5	order_no	平台订单号	String	原样返回
6	utr	utr	String	平台订单utr
7	acc_no	收款账号	String	原样返回
8	acc_name	收款户名	String	原样返回
9	email	邮箱	String	邮箱
10	ccy_no	币种	String	原样返回
11	order_amount	金额	String	原样返回
12	fee	手续费	String	手续费
13	status	订单状态	String	SUCCESS:成功 FAIL:失败 UNKNOW:处理中
14	err_code	数字签名	String	订单错误码
15	err_msg	错误信息	String	订单错误描述

请求成功返回参数示例

{
  "order_no": "202104060000001719561153501557",
  "mer_no": "xxx",
  "request_no": "1617698213425",
  "query_status": "SUCCESS",
  "fee": "10.50",
  "sign": "842628d8c151e26f439023eba701394c",
  "acc_name": "Zhang San",
  "request_time": "20210406153653",
  "err_msg": "",
  "order_amount": "10.00",
  "acc_no": "15846325",
  "ccy_no": "VND",
  "mer_order_no": "1617698100961",
  "query_err_code": "000002",
  "query_err_msg": "Business verification success",
  "status": "UNKNOW"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# 代付余额查询

简要描述：

查询商户账户余额。

请求URL：

https://settle.mango-pay.net/withdraw/balanceQuery (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	request_no	请求流水号	String	是	请求流水号必须唯一，每次需不同
2	request_time	请求时间戳	String	是	时间戳格式:( yyyyMMddHHmmss)，采用东七区时间戳
3	mer_no	商户号	String	是	平台分配的唯一商户号
4	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "mer_no": "xxx",
  "request_time": "20210406153905",
  "request_no": "1617698345334",
  "sign": "xxx"
}

1
2
3
4
5
6

返回错误说明

序号	参数名	参数名称	类型	说明
1	query_status	查询状态	String	SUCCESS 成功,FAIL 失败；只表示代表查询状态，不表示业务状态
2	query_err_code	查询错误码	String	查询错误码
3	query_err_msg	查询错误信息	String	查询错误描述

query_status等于SUCCESS以下数据才返回

序号	参数名	参数名称	类型	说明
1	request_no	请求流水号	String	原样返回
2	request_time	请求时间戳	String	原样返回
3	mer_no	商户号	String	原样返回
4	list{account_no}	子账号	String	list，多笔
5	list{ccy_no}	币种	String	list，多笔
6	list{balance}	可用余额	String	list，多笔
7	list{frozen_balance}	冻结余额	String	list，多笔;整数
8	list{sign}	数字签名	String	详见：数字签名规范

请求成功返回参数示例

{
  "mer_no": "xxx",
  "request_time": "20210406153905",
  "request_no": "1617698345334",
  "query_status": "SUCCESS",
  "list": [
    {
      "account_no": "9110200000028799",
      "ccy_no": "IDR",
      "balance": "22535331.25",
      "frozen_balance": "0.00",
      "sign": "xxx"
    },
    {
      "account_no": "9110200000028743",
      "ccy_no": "INR",
      "balance": "9867.22",
      "frozen_balance": "0.00",
      "sign": "e47652c689c8cab2162635ff70166606"
    },
    {
      "account_no": "9021600000518997",
      "ccy_no": "NGN",
      "balance": "60633.86",
      "frozen_balance": "0.00",
      "sign": "f36807a3fd65a2ea6fe0ae7e25eabba3"
    },
    {
      "account_no": "9111700000054909",
      "ccy_no": "THB",
      "balance": "35206.94",
      "frozen_balance": "0.00",
      "sign": "3357463f515b3767370a903305823cc1"
    },
    {
      "account_no": "9111700000058884909",
      "ccy_no": "USDTERC",
      "balance": "1379.00",
      "frozen_balance": "0.00",
      "sign": "d86fa4207f884823a3e9b8e2bc0681ab"
    },
    {
      "account_no": "9111000000036280",
      "ccy_no": "VND",
      "balance": "10101.49",
      "frozen_balance": "0.00",
      "sign": "0d15f761d263c1a07063551e9ca0d7ad"
    }
  ],
  "query_err_code": "000002",
  "query_err_msg": "余额查询 success"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# 平台通知

# 支付通知

简要描述：

当支付订单客户支付成功时，支付中心会向商户业务系统发起回调通知。
如果商户系统没有正确返回，支付网关会延迟再次通知。
商户接收到回调信息处理业务代码成功，需要返回 SUCCESS,否则平台会已10分钟发送3次通知,60分钟5次通知,24小时内10次通知,商户需要正确处理多次通知,防止资金重复处理。
注所有回调参数除sign之外,其余不为空参数都需要带入签名

请求URL：

回调notifyUrl参数

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/x-www-form-urlencoded	HTTP请求内容类型

参数说明

序号	参数名	参数名称	类型	是否返回	说明
1	busi_code	支付类型	String	是	支付类型编码
2	err_code	错误码	String	否	错误码
3	err_msg	错误信息	String	否	错误描述
4	mer_no	商户号	String	是	商户编号
5	mer_order_no	商户订单号	String	是	商户唯一订单号
6	order_amount	订单金额	String	是	保留二位小数
7	order_no	平台订单号	String	是	平台唯一订单号
8	order_time	订单时间	String	是	格式 (yyyy-MM-dd HH:mm:ss)
9	pay_amount	支付金额	String	是	保留两位小数
10	utr	支付utr	String	否	支付成功时返回
11	pay_time	支付时间	String	是	格式 (yyyy-MM-dd HH:mm:ss)
12	status	订单状态	String	是	SUCCESS：成功 FAIL:失败
13	sign	数字签名	String	是	详见：数字签名规范

# 转账通知

简要描述：

当转账订单上游付款成功时，支付中心会向商户业务系统发起回调通知。
如果商户系统没有正确返回，支付网关会延迟再次通知。
商户接收到回调信息处理业务代码成功，需要返回 SUCCESS,否则平台会已10分钟发送3次通知,60分钟5次通知,24小时内10次通知,商户需要正确处理多次通知,防止资金重复处理。
注所有回调参数除sign之外,其余不为空参数都需要带入签名

请求URL：

回调notifyUrl参数

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/x-www-form-urlencoded	HTTP请求内容类型

参数说明

序号	参数名	参数名称	类型	是否返回	说明
1	err_code	错误码	String	否	错误码
2	err_msg	错误信息	String	否	错误描述
3	mer_no	商户号	String	是	商户编号
4	mer_order_no	商户订单号	String	是	商户订单号
5	order_amount	订单金额	String	是	保留二位小数
6	ccy_no	币种	String	是	币种
7	order_no	平台订单号	String	是	平台订单号
8	utr	支付utr	String	否	转账成功时返回
9	create_time	订单创建时间	String	是	格式 (yyyy-MM-dd HH:mm:ss)
10	pay_time	订单支付时间	String	否	格式 (yyyy-MM-dd HH:mm:ss)
11	status	订单状态	String	是	SUCCESS:成功 FAIL:失败 UNKNOW:处理中
12	sign	数字签名	String	是	详见：数字签名规范

# 币种编码

币种编码（大写）

序号	编码	名称
1	INR	印度卢比

感谢您的阅读！

# Mangopay接口文档

# 本站内容介绍

# 数字签名规范

# 商户测试账号基本信息

# RSA公钥生成步骤规则参考

# Md5加密格式案例(案例只做参考)

# RSA加密格式案例(案例只做参考)

# 加密算法工具类

# 支付类型编码

# 支付业务

# 支付下单

Post

# 支付查询

Post

# 支付补单

Post

# 查询utr

Post

# 查询upi

Post

# 代付业务

# 单笔代付

Post

# 代付订单查询

Post

# 代付余额查询

Post

# 平台通知

# 支付通知

Post

# 转账通知

Post

# 币种编码