# 2.通用API说明

商户服务器和 AllPay 网关对接的通用接口,每个渠道都具有的功能,包括:消费,退款,查询接口。 

## 2.1. 验签说明

1.对于发送到 ALLPAY 系统的 POST 请求报文，其中所有传入参数(除 signature 参数外)按照字段名的 ASCII 码从小到大排序后(字典序)，使用 URL 键值对的格式(即 key1=value1&key2=value2...)拼接成字符串 String1。

2.在 String1 最后直接拼接(不需要用“&”连接)双方约定的签名密钥 K1(接入时 ALLPAY 时分配)，得到 stringSignTemp 字符串,并对 stringSignTemp 进行 md5 运算，得到 signature 的值。

3.示例签名串

```js
acqID=99020344&backURL=http://example.com/example&charSet=UTF- 8&frontURL=nil&merID=000000000000015&merReserve=nil&orderAmount=0.01&orderCurre ncy=CNY&orderNum=869873851812&paymentSchema=APMP&signType=MD5&transTime= 20151112151356&transType=PURC&version=VER0000000022f2c77e3718c47cfb47a89a6fbc9d361
```

## 2.2. 通用API 接入地址

 交易名称  |开发调试地址|生产交易地址  
 ------- |-----------|-------
 消费接口 |<https://mchapi.allpayx.com/testjspay> |<https://mchapi.allpayx.com/jspay>
 查询接口 |<https://testapi.allpayx.com/pay/v1> |<https://api.allpayx.com/pay/v1>
 退款接口 |<https://testapi.allpayx.com/pay/v1> |<https://api.allpayx.com/pay/v1>