# SunShinePay接口文档

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

# 本站内容介绍

SunShine-Pay支付文档

商户系统

1.商户账号申请：

联系平台运营人员获取

2.商户系统网址

https://merchant.sunshine-pay.com (opens new window)

3.商户登录系统

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

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

# 数字签名规范

# 商户测试账号基本信息

测试商户基本信息：

"商户名":TestingMerchants
"商户编号":861100000027012
"商户秘钥":220F33F3591FDE8C9019A40328C69200

1
2
3

测试商户RSA公钥：

MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC1AhnMAkkO2QaMwT9nyKX422rOvFmvFqUbz2TVmWhhD7pDA0KOzN8sHz3l7VIPw2M1yR/V5/LWI2VLPB/nYCa6pEjZV/+XD7SsNDFrR0vPPxhv6QL6awsJbsvNIfm1fXDNjLwUFI3CHH9ZIXyBPut1uK/nYk0kM0pCA65TeXEUxQIDAQAB

测试商户RSA私钥：

MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmEwggJdAgEAAoGBALUCGcwCSQ7ZBozBP2fIpfjbas68Wa8WpRvPZNWZaGEPukMDQo7M3ywfPeXtUg/DYzXJH9Xn8tYjZUs8H+dgJrqkSNlX/5cPtKw0MWtHS88/GG/pAvprCwluy80h+bV9cM2MvBQUjcIcf1khfIE+63W4r+diTSQzSkIDrlN5cRTFAgMBAAECgYA1xDD7e3ZOFcMvTjvSTTSXzj1UuXf+XUCgGSO/mvj5U92lCDPeDRcBmSoewTbN/eDbWim9tU9ZslvlVC+538LA0Bfzn2T3Si2gtoNquoNSv+Ql1KsrZAvGRrwNHHSJQZlUwWxqmAGkAr8mws+7JarBL0wO/nXLN2nfpaGhf5a65QJBAN37eVI/+jNkGeBBmpDLRk3B/mTCfKeQoFQi1pXGd4QG57rotR7O/XCEs8FIfRuGWIFJJTYAPNWmX70BhjHWogMCQQDQvy7ScNh7ntg1Iv5ip3GVrikgMKhGtFWHkVwq8aofM0rYPacZCbZmANwHk2WhasivQGGxx8XUUmcg5zpH7deXAkBtHqlM3VZI3PQ7YQRyGPq+TpaXQWO1m0q1EUsa5SzrIdnX73zZYDcFkLYsVU3qseff5ez81rEQ9XAqoQ0ugquxAkEAsF3HJn+3OAMF8yckvJ9yRR+Hma3ijxJP7SFwOMxDiubgRoEYi/v7woTZYgEz7cR12DPSFs2NpI0WmuMiB6G48wJBAJxMHGjfuJKFG30Ib5+2bwRH+8wahUDKmVTlNKbEaen0uea8pCGVqcsOM1OaWQc466ELrqYlttJYOLCElsitUv8=

所有接口的签名规范：

将所有参数按照字段名的 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,即第一行和最后一行
访问http://www.ab173.com/gongju/other/compress.php (opens new window) 将生成的公钥和私钥复制到压缩文本框中去除换行和空格
把公钥上传至商户后台,平台会使用该公钥进行解密并且验签。
私钥自己隐秘保存(加密用)

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

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

例:

加密前

busi_code=101202&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=101202&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.sunshine-pay.com/download (opens new window)

# 支付类型编码

支付类型编码	支付类型说明
101202	菲律宾代收

# 支付业务

# 支付下单

简要描述：

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

请求URL：

https://core.sunshine-pay.com/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	是	币种编码例:PHP:菲律宾比索
8	busi_code	支付类型编码	String	是	101202 详情见：支付类型编码
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": "101202",
  "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	upi	下单账号	String	下单成功时有值
12	link	二维码信息	String	下单成功时有值
13	pname	下单人姓名	String	原路返回
14	pemail	下单人email姓名	String	原路返回
15	phone	手机号	String	原路返回
16	ccy_no	币种编码	String	原路返回
17	sign	数字签名	String	下单成功返回详见：数字签名规范
18	err_code	错误码	String	请求失败返回错误码
19	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": "101202",
  "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.sunshine-pay.com/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	pay_amount	实际支付金额	String	实际支付金额
6	order_time	订单时间	String	时间戳：(格式为yyyyMMddHHmmss 4位年+2位月+2位日+2位时+2位分+2位秒)
7	pay_time	支付时间	String	时间戳：(格式为yyyyMMddHHmmss 4位年+2位月+2位日+2位时+2位分+2位秒)
8	order_status	订单状态	String	UNPAY:待支付 SUCCESS:成功 FAIL:失败
9	order_err_code	订单错误码	String	错误码
10	order_err_msg	订单错误信息	String	错误描述
11	sign	数字签名	String	详见：数字签名规范
12	query_err_code	查询错误码	String	请求失败返回错误码
13	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

# 代付业务

# 单笔代付

简要描述：

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

请求URL：

https://settle.sunshine-pay.com/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	是	收款账号(如GCash 请填收款手机号)
4	acc_name	收款户名	String	是	收款姓名
5	ccy_no	币种	String	是	币种例:PHP:菲律宾比索
6	order_amount	金额	String	是	比索为单位,保留二位小数
7	bank_code	银行编码	String	是	代付类型,会员代付时使用的出款银行，如Gcash 请填 gcash.联系运营人员获取编码列表
8	mobile_no	手机号	String	是	手机号（收款手机号）
9	email	邮箱	String	是	邮箱
10	notifyUrl	回调地址	String	是	代付提交成功,有最终结果,均会向该地址发送回调
11	summary	备注	String	是	备注
12	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "summary": "summary",
  "bank_code": "BANK",
  "acc_name": "zhangsan",
  "mer_no": "xxx",
  "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": "PHP",
  "mer_order_no": "testOrder1650535029326"
}

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

返回错误说明

序号	参数名	参数名称	类型	说明
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": "861100000010620",
    "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.sunshine-pay.com/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.sunshine-pay.com/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	pay_time	支付时间	String	是	格式 (yyyy-MM-dd HH:mm:ss)
11	status	订单状态	String	是	SUCCESS：成功 FAIL:失败
12	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	PHP	菲律宾比索

# 银行列表

代付支持的银行编码（区分大小写）

银行编码bank_code	银行名称bank_name
gcash	GCash
BCH	Bank of China
BRB	Binangonan Rural Bank / BRBDigital
SME	CARD SME Bank
CPI	CIMB Philippines, Inc.
ERB	Entrepreneur Rural Bank, Inc./ENTRP
GOT	GoTyme Bank
IRI	I-Remit / iCASH
IEM	Infoserve / Nationlink
LDB	Luzon Development Bank
PAS	Pacific Ace Savings Bank
PPS	PalawanPay
TDB	Tonik Bank
TPI	TraxionPay/DigiCOOP/COOPNET
UDB	UnionDigital Bank
WDB	Wealth Development Bank
VB	Veterans Bank
USSC	USSC Money Services
USB	UCPB Savings Bank
TC	TayoCash
SSB	Sun Savings Bank
SLB	Sterling Bank of Asia
STP	Starpay
SCB	Standard Chartered Bank
SP	ShopeePay
SB	Seabank
RBB	Robinsons Bank Corporation
QCRB	Quezon Capital Rural Bank
QB	Queenbank
PDB	Producers Bank
PTC	Philippine Trust Company
PBB	Philippine Business Bank
PMP	PayMaya Philippines
PRB	Partner Rural Bank (Cotabato), Inc.
OP	OmniPay, Inc.
NB	Netbank
MCCB	Mindanao Consolidated CoopBank
MBP	Maybank Philippnies
MBS	Malayan Bank Savings and Mortgage Bank, Inc.
LSB	Legazpi Saving Bank
Komo	East West Rural Bank / Komo
JC	Zybi Tech Inc. / JuanCash
ISLA	ISLA Bank
GP	GrabPay
ESB	Equicom Savings Bank, Inc.
DB	Dungganon Bank
DCDB	Dumaguete City Development Bank
CTBC	CTBC Bank (Philippines) Corporation
Coins	DCPay / COINS.PH
CBS	China Bank Savings
CLB	Cebuana Lhuillier Bank / Cebuana Xpress
CARD	CARD Bank
CB	Camalig Bank
BNB	BDO NeTwork Bank
Bayad	CIS Bayad Center / Bayad
BK	BanKo,A Subsidiary of BPI
BC	Bank of Commerce
BM	Bangko Mabuhay
Asenso	Rural Bank of Guinobatan / Asenso
AB	ALLBANK(A Thirft Bank)
DBP	Development Bank of the Philippines
PBC	Philippine Bank of Communications
AUB	Asia United Bank Corporation
PSB	Philippine Savings Bank
UCPB	United Coconut Planters Bank (UCPB)
RCBC	RCBC/DiskarTech
EWBC	East West Banking Corporation
CBC	China Banking Corporation
PNB	Philippine National Bank
UBP	Union Bank of the Philippines
SBC	Security Bank Corporation
LBOB	LANDBANK / OFBank
MBT	Metropolitan Bank and Trust Co
Unibank	BDO Unibank
BPI	BPI Bank

感谢您的阅读！

# SunShinePay接口文档

# 本站内容介绍

# 数字签名规范

# 商户测试账号基本信息

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

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

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

# 加密算法工具类

# 支付类型编码

# 支付业务

# 支付下单

Post

# 支付查询

Post

# 代付业务

# 单笔代付

Post

# 代付订单查询

Post

# 代付余额查询

Post

# 平台通知

# 支付通知

Post

# 转账通知

Post

# 币种编码

# 银行列表