梅泰诺缴费接口技术文档V1.0

接口技术文档
梅泰诺话费充值平台
--接口技术文档
文件编号：MTN—JFJK－D01
版本：1.1
目录
1.接口说明 (3)
2.接口定义 (3)
2.1.缴费接口 (3)
2.1.1.提交地址 (3)
2.1.2.提交方式 (3)
2.1.3.提交参数 (3)
2.1.4.签名sign算法 (4)
2.1.5.应答参数 (4)
2.1.6.状态码定义 (4)
2.2.余额查询接口 (5)
2.2.1.提交地址 (5)
2.2.2.提交方式 (5)
2.2.3.提交参数 (5)
2.2.4.签名sign算法 (6)
2.2.5.应答参数 (6)
2.2.6.状态码定义 (6)
2.3.订单查询接口 (6)
2.3.1.提交地址 (6)
2.3.2.提交方式 (6)
2.3.3.提交参数 (6)
2.3.4.签名sign算法 (7)
2.3.5.应答参数 (7)
2.3.6.状态码定义 (7)
2.3.7.充值结果定义 (7)
2.4.缴费回调接口 (8)
2.4.1.提交地址 (8)
2.4.2.提交方式 (8)
2.4.3.提交参数 (8)
2.4.4.签名sign算法 (8)
2.4.5.应答参数 (9)
1. 接口说明
◆本文档中涉及接口提供给梅泰诺合作伙伴调用，合作伙伴通过HTTP协议
将业务信息提交到梅泰诺话费充值平台，平台收到请求后进行合法性校验，校验通过后返回受理结果。

◆接口中用到的代理商编号和密钥（Key）由梅泰诺充值平台分配。

◆正式上线前请合作伙伴提供服务器外网IP，平台绑定IP后接口才能调用，
否则将返回失败。

◆双方都需验证签名sign值的合法性，验证失败请终止交易并与梅泰诺技术
团队沟通。

◆请注意各参数的大小写。

◆IP、Port请在商务合作确认后向梅泰诺运营人员获取。

2. 接口定义
2.1. 缴费接口
2.1.1.提交地址
http://ip:port/Receiver
2.1.2.提交方式
POST
2.1.
3.提交参数
2.1.4.签名sign算法
（agentid + orderId +amount +userToken +key），进行MD5加密后（MD5出来的32位16进制的小写字母）的密文串，请注意各字母的大小写
2.1.5.应答参数
状态码|状态描述
2.1.6.状态码定义
2.2. 余额查询接口
2.2.1.提交地址
http://ip:port/QueryMerchant 2.2.2.提交方式
POST
2.2.
3.提交参数
2.2.4.签名sign算法
(agentid + key)，进行MD5加密后（MD5出来的32位16进制的字母）的密文串
2.2.5.应答参数
返回码|代理商编号|余额|sign
例：000000|agent0000001|30000|220aae48a8efbd74e8420a787a9c07c1
2.2.6.状态码定义
2.3.订单查询接口
2.3.1.提交地址
http://ip:port/QueryOrder
2.3.2.提交方式
POST
2.3.3.提交参数
2.3.4.签名sign算法
(agentid + orderId + key)，进行MD5加密后（MD5出来的32位16进制的字母）的密文串。

2.3.5.应答参数
返回值|代理商编号|订单编号|手机号码|订单金额|订单充值结果|sign
例：
000000|agent00001|order123123|151*******|49.5|4|220aae48a8efbd74e8420a78 7a9c07c1
2.3.6.状态码定义
2.3.7.充值结果定义
2.4. 缴费回调接口
2.4.1.提交地址
合作伙伴如需要梅泰诺平台在处理完充值订单后主动通知订单处理结果，则需要在提交充值订单时填写callbackurl，否则不予返回。

2.4.2.提交方式
POST
2.4.
3.提交参数
2.4.4.签名sign算法
(agentid + orderId +amount +userToken+ key)，进行MD5加密后（MD5出来的32位16进制的字母）的密文串。

2.4.5.应答参数
success
注：要求合作伙伴在收到通知后回应“success”，若平台没有收到合作伙伴的回应，或回调请求因网络异常等情况没有提交成功，则平台会在1分钟后重试，重试3次都失败则不再通知。