1. 获取商户编号和密钥

在接入群找技术分配获取

2. API 签名

2.1 签名算法

类型	说明
算法	SHA512

2.3 所有下单请求需要加 HTTP Header 标准签名参数

通用头部请参数说明（以下参数放入http header中）

参数	参数名称	参数类型	必填	案例
serviceName	服务名称	String	是	api.pay
mchId	商户编号;商户 KYB 通过后分配的数字编号	String	是	2020423200001
signType	加签类型	String	是	SHA512
timestamp	时间戳（s）	String	是	1713110548
sign	签名字符串	String	是

2.4 Sign 签名规则

使用 SHA512 签名算法对 Signature 字符串签名即可

Signature 签名的字符串规则: mchId + serviceName + method + timestamp + signType + data + key

mchId、serviceName、method、timestamp、signType 为 HTTP Header 参数

data 为 API 下单时的 payload 数据，即 JSON 下单参数

key 为 KYB 通过后的分配的商户密钥

2.5 签名案例

请求报文

响应报文

实际签名

POST /gateway/base/biz HTTP/1.1
method: pay
signType: SHA512
serviceName: api.pay
mchId: 1416010331032883233
timestamp: 1631671670
sign: 9d7bb11c4faf54523b24bd65fa9e104e0b926e7e7932b5c99ba4b1d017f5aed8b5190bedb6b149f745ff768a2faaee78485207943004d2575380d3e3cc00c718
Content-Type: application/json

{
"amount": "5.00",
"callbackUrl": "http://127.0.0.1:8082/callback",
"redirectUrl":"http://www.baidu.com",
"currency": "BRL",
"dynamic": "1",
"email": "muazpe@gmail.com",
"firstname": "Murilo Azeredo Pereira",
"lastname": "your lasttname",
"mchOrderId": "1232434323233463411fv34",
"phone": "+5511967164793",
"docNumber": "14868845802",
"docType": "CPF",
"productinfo": "your pro simple desc"
}

3 API 响应格式

API HTTP 响应标准格式

响应的数据是JSON格式 httpCode 200 表示请求成功，httpCode 400 表示请求信息错误

参数	参数名称	参数类型	是否必填	案例
resultCode	结果编码	String	是	成功:000000 失败:XXXXXX
errorCode	错误码	String	是	成功:000000 失败:XXXXXX
errorMsg	错误码说明	String	否
data	响应数据	Object	否	返回 JSON 数据
timestamp	时间戳（s）	String	否

HTTP 响应参数说明（所有 API 响应都按以上格式返回）

2.2 API HTTP 请求注意事项

调用 Method：HTTPS POST（不支持GET方式），The API 基于 HTTPS;

请求响应 JSON 数据格式, 采用 merchant key + SHA512 签名 + IP 白名单方式保证请求数据安全和网络安全;

由于系统存在主动回调和自动回调等回调情况，可能一笔单多次回调商户，请做好防重复处理，避免造成交易异常;

实际生产需要绑定客户服务端请求下单IP，跳转无需IP绑定;

“+”：案例中拼装字符串时候，加号表示的是连接的意思。

API 签名

1. 获取商户编号和密钥#

2. API 签名#

2.1 签名算法#

2.3 所有下单请求需要加 HTTP Header 标准签名参数#

2.4 Sign 签名规则#

2.5 签名案例#

3 API 响应格式#

API HTTP 响应标准格式#

2.2 API HTTP 请求注意事项#

1. 获取商户编号和密钥

2. API 签名

2.1 签名算法

2.3 所有下单请求需要加 HTTP Header 标准签名参数

2.4 Sign 签名规则

2.5 签名案例

3 API 响应格式

API HTTP 响应标准格式

2.2 API HTTP 请求注意事项