1. 代付接口
请求网关：https://gate.longpay.com/agentpay/index
注意，提交方式是 POST ，GET 字符编码 GB2312
请求参数：
| 参数名称 | 参数含义 | 是否必填 | 参与签名 | 参数说明 |
|---|---|---|---|---|
| parter | 商户ID | Y | Y | 平台分配 |
| orderid | 代付订单号 | Y | Y | |
| amount | 代付金额 | Y | Y | 单位元,精确到分 |
| accout_type | 账号类型 | Y | Y | 0对私,1对公 |
| account_no | 银行卡号 | Y | Y | |
| account_name | 开户姓名 | Y | Y | |
| bank_code | 开户银行编号 | N | N | 详见代付银行编码表,文档底部 |
| bank_province | 省份 | N | N | 详见代付省份编码表,文档底部 |
| bank_city | 城市 | N | N | 详见代付城市编码表,文档底部 |
| bank_branch | 分行 | N | N | |
| nonce_str | 随机字符 | Y | Y | 只能字母或数字的组合或纯数字(必须每一次都Y唯一,最长32位) |
| callbackurl | 回调地址 | N | N | 代付提交成功通知地址网址,需要以http://开头且没有任何参数 |
| attach | 备注消息 | N | N | |
| sign | MD5签名 | Y | N | 请求MD5签名字段格式 |
请求签名算法：
string stringSignTemp="parter={?}&orderid={?}&amount={?}&accout_type={?}&account_no={?}&account_name={?}&nonce_str={?}{apikey}
sign=MD5(stringSignTemp).toLowerCase()
签名采用32位小写MD5签名值，GB2312编码
同步响应参数：
| 参数名称 | 参数含义 | 参数说明 |
|---|---|---|
| code | 状态码 | 0000为成功9999时需要通过查询接口确认请求是否成功其他为失败 |
| msg | 消息说明 | 提交成功，其他为失败说明 |
支付结果同步返回json数据格式通知，如果返回是{"code":"0000","msg":"提交成功"}，说明代付申请成功,code 为 9999 需要通过查询接口确认请求是否成功,其他为失败。
2. 代付结果通知
支付成功，系统会给订单通知地址通知，接收成功返回：success
如果没有返回 success，系统则会在接下来每分钟通知一次，最多5次
提交方式：采用GET方式
字符编码：GB2312
签名算法：MD5
参数：
| 参数 | 说明 | 备注 |
|---|---|---|
| parter | 商户号 | 由龙宝系统分配 |
| orderid | 商户订单号 | 商户提交的 |
| sysorderid | 龙宝订单号 | 龙宝系统订单号 |
| status | 支付状态 | 返回位大写字母 P = 处理中, S = 付款成功 , F = 付款失败 |
| desc | 支付状态说明 | 支付状态中文说明 |
| amount | 订单金额 | 单位元,精确到分 |
| nonce_str | 随机字符 | 32位,字母与数字 |
| attach | 备注 | 透传参数 |
| sign | 签名 | "parter=" + parter + "&orderid=" + orderid + "&sysorderid=" + sysorderid+ "&status=" + status+ "&desc=" + desc+ "&amount=" + amount+ "&nonce_str=" + nonce_str + apiKey |
商户收到通知，立即返回 success 字符串
3. 查询接口
查询网关：https://gate.longpay.com/agentpay/query
注意，提交方式是 POST ，GET 编码 GB2312
请求参数：
| 参数名称 | 参数含义 | 是否必填 | 参与签名 | 参数说明 |
|---|---|---|---|---|
| parter | 商户ID | Y | Y | 平台分配 |
| orderid | 代付订单号 | Y | Y | |
| nonce_str | 随机字符 | Y | Y | |
| sign | MD5签名 | Y | N | 查询MD5签名字段格式 |
查询签名算法：
stringSignTemp=parter={?}&orderid={?}&nonce_str={?}{apikey}
sign=MD5(stringSignTemp).toLowerCase()
签名采用32位小写MD5签名值，GB2312编码
查询返回参数：
| 参数名称 | 参数含义 | 参数说明 |
|---|---|---|
| code | 结果通知代码 | 0000 代表查询成功 |
| msg | 结果通知消息 | 查询成功 和 其他 |
| 以下参数只有在 code 为 0000 的时候才会有。 | ||
| data | 以下参数包含在data中 | |
| parter | 商户ID | 平台分配 |
| sysorderid | 龙宝代付订单号 | |
| status | 状态值 | P:处理中,S:付款成功,F:付款失败 |
| desc | 通知消息 | |
| amount | 金额(单位元,精确到分) | |
| nonce_str | 随机字符 | 只能字母或数字(必须保证唯一) |
| sign | MD5签名 | 查询返回MD5签名字段格式 |
查询返回签名算法：
stringSignTemp=parter={0}&orderid={1}&sysorderid={2}&status={3}&desc={4}&amount={5}&nonce_str={6}{apikey}
sign=MD5(stringSignTemp).toLowerCase()
签名采用32位小写MD5签名值，GB2312编码
4. 余额接口
余额网关：https://gate.longpay.com/agentpay/querybalance
注意，提交方式是 POST ，GET 编码 GB2312
请求参数：
| 参数名称 | 参数含义 | 是否必填 | 参与签名 | 参数说明 |
|---|---|---|---|---|
| parter | 商户ID | Y | Y | 平台分配 |
| nonce_str | 随机字符 | Y | Y | |
| sign | MD5签名 | Y | N | 余额MD5签名字段格式 |
余额签名算法：
stringSignTemp=parter={?}&nonce_str={?}{apikey}
sign=MD5(stringSignTemp).toLowerCase()
签名采用32位小写MD5签名值，GB2312编码
余额返回参数：
| 参数名称 | 参数含义 | 参数说明 |
|---|---|---|
| code | 结果通知代码 | 0000 代表查询成功 |
| msg | 结果通知消息 | 查询成功 和 其他 |
| 以下参数只有在 code 为 0000 的时候才会有。 | ||
| data | 以下参数包含在data中 | |
| availablebalance | 可用余额 | |
| totalbalance | 总余额 | |
| nonce_str | 随机字符 | 只能字母或数字(必须保证唯一) |
| attach | 备注消息 | |
| sign | MD5签名 | 余额返回MD5签名字段格式 |
余额返回签名算法：
stringSignTemp=parter={0}&availablebalance={1}&totalbalance={2}&nonce_str={3}{apikey}
sign=MD5(stringSignTemp).toLowerCase()
签名采用32位小写MD5签名值，GB2312编码
5. 代付银行编码
| 银行编码 | 银行名称 |
|---|---|
| ECITIC | 中信银行 |
| BOC | 中国银行 |
| ABC | 农业银行 |
| CCB | 建设银行 |
| ICBC | 工商银行 |
| CMB | 招商银行 |
| PSBC | 中国邮政储蓄银行 |
| CIB | 兴业银行 |
| SPDB | 浦发银行 |
| PAB | 平安银行 |
| CMBC | 民生银行 |
| BOCOM | 交通银行 |
| HXB | 广东发展银行 |
| CEB | 中国光大银行 |
6. 城市附录
| 省份 | 城市 |
|---|---|
| 北京市 | 北京市 |
| 天津市 | 天津市 |
| 河北省 | 石家庄市,唐山市,秦皇岛市,邯郸市,邢台市,保定市,张家口市,承德市,沧州市,廊坊市,衡水市 |
| 山西省 | 太原市,大同市,阳泉市,长治市,晋城市,朔州市,晋中市,运城市,忻州市,临汾市,吕梁市 |
| 内蒙古自治区 | 呼和浩特市,包头市,乌海市,赤峰市,通辽市,鄂尔多斯市,呼伦贝尔市,巴彦淖尔市,乌兰察布市,兴安盟,锡林郭勒盟,阿拉善盟 |
| 辽宁省 | 沈阳市,大连市,鞍山市,抚顺市,本溪市,丹东市,锦州市,营口市,阜新市,辽阳市,盘锦市,铁岭市,朝阳市,葫芦岛市 |
| 吉林省 | 长春市,吉林市,四平市,辽源市,通化市,白山市,松原市,白城市,延边朝鲜族自治州 |
| 黑龙江省 | 哈尔滨市,齐齐哈尔市,鸡西市,鹤岗市,双鸭山市,大庆市,伊春市,佳木斯市,七台河市,牡丹江市,黑河市,绥化市,大兴安岭地区 |
| 上海市 | 上海市 |
| 江苏省 | 南京市,无锡市,徐州市,常州市,苏州市,南通市,连云港市,淮安市,盐城市,扬州市,镇江市,泰州市,宿迁市 |
| 浙江省 | 杭州市,宁波市,温州市,嘉兴市,湖州市,绍兴市,金华市,衢州市,舟山市,台州市,丽水市 |
| 安徽省 | 合肥市,芜湖市,蚌埠市,淮南市,马鞍山市,淮北市,铜陵市,安庆市,黄山市,滁州市,阜阳市,宿州市,巢湖市,六安市,亳州市,池州市,宣城市 |
| 福建省 | 福州市,厦门市,莆田市,三明市,泉州市,漳州市,南平市,龙岩市,宁德市 |
| 江西省 | 南昌市,景德镇市,萍乡市,九江市,新余市,鹰潭市,赣州市,吉安市,宜春市,抚州市,上饶市 |
| 山东省 | 济南市,青岛市,淄博市,枣庄市,东营市,烟台市,潍坊市,济宁市,泰安市,威海市,日照市,莱芜市,临沂市,德州市,聊城市,滨州市,荷泽市 |
| 河南省 | 郑州市,开封市,洛阳市,平顶山市,安阳市,鹤壁市,新乡市,焦作市,濮阳市,许昌市,漯河市,三门峡市,南阳市,商丘市,信阳市,周口市,驻马店市 |
| 湖北省 | 武汉市,黄石市,十堰市,宜昌市,襄樊市,鄂州市,荆门市,孝感市,荆州市,黄冈市,咸宁市,随州市,恩施土家族苗族自治州,神农架 |
| 湖南省 | 长沙市,株洲市,湘潭市,衡阳市,邵阳市,岳阳市,常德市,张家界市,益阳市,郴州市,永州市,怀化市,娄底市,湘西土家族苗族自治州 |
| 广东省 | 广州市,韶关市,深圳市,珠海市,汕头市,佛山市,江门市,湛江市,茂名市,肇庆市,惠州市,梅州市,汕尾市,河源市,阳江市,清远市,东莞市,中山市,潮州市,揭阳市,云浮市 |
| 广西壮族自治区 | 南宁市,柳州市,桂林市,梧州市,北海市,防城港市,钦州市,贵港市,玉林市,百色市,贺州市,河池市,来宾市,崇左市 |
| 海南省 | 海口市,三亚市 |
| 重庆市 | 重庆市 |
| 四川省 | 成都市,自贡市,攀枝花市,泸州市,德阳市,绵阳市,广元市,遂宁市,内江市,乐山市,南充市,眉山市,宜宾市,广安市,达州市,雅安市,巴中市,资阳市,阿坝藏族羌族自治州,甘孜藏族自治州,凉山彝族自治州 |
| 贵州省 | 贵阳市,六盘水市,遵义市,安顺市,铜仁地区,黔西南布依族苗族自治州,毕节地区,黔东南苗族侗族自治州,黔南布依族苗族自治州 |
| 云南省 | 昆明市,曲靖市,玉溪市,保山市,昭通市,丽江市,思茅市,临沧市,楚雄彝族自治州,红河哈尼族彝族自治州,文山壮族苗族自治州,西双版纳傣族自治州,大理白族自治州,德宏傣族景颇族自治州,怒江傈僳族自治州,迪庆藏族自治州 |
| 西藏自治区 | 拉萨市,昌都地区,山南地区,日喀则地区,那曲地区,阿里地区,林芝地区 |
| 陕西省 | 西安市,铜川市,宝鸡市,咸阳市,渭南市,延安市,汉中市,榆林市,安康市,商洛市 |
| 甘肃省 | 兰州市,嘉峪关市,金昌市,白银市,天水市,武威市,张掖市,平凉市,酒泉市,庆阳市,定西市,陇南市,临夏回族自治州,甘南藏族自治州 |
| 青海省 | 西宁市,海东地区,海北藏族自治州,黄南藏族自治州,海南藏族自治州,果洛藏族自治州,玉树藏族自治州,海西蒙古族藏族自治州 |
| 宁夏回族自治区 | 银川市,石嘴山市,吴忠市,固原市,中卫市 |
| 新疆维吾尔自治区 | 乌鲁木齐市,克拉玛依市,吐鲁番地区,哈密地区,昌吉回族自治州,博尔塔拉蒙古自治州,巴音郭楞蒙古自治州,阿克苏地区,克孜勒苏柯尔克孜自治州,喀什地区,和田地区,伊犁哈萨克自治州,塔城地区,阿勒泰地区,石河子市,阿拉尔市,图木舒克市,五家渠市 |
| 香港特别行政区 | 香港特别行政区 |
| 澳门特别行政区 | 澳门特别行政区 |
| 台湾省 | 台湾省 |