公共参数
请求参数说明
| 参数 | 类型 | 必填 | 参数说明 | 样例 |
|---|---|---|---|---|
| method | String(32) | 是 | 接口名称 | basicexpay.trade.cashier |
| merNo | String(32) | 是 | 商户编码，由币趣支付商户系统分配，通过商户平台可查看 | 811496833912834 |
| timestamp | String(14) | 是 | 交易时间戳，14 位长度,格式 :yyyyMMddHHmmss | 20230217163650 |
| nonce | String(32) | 是 | 随机字符串，由数字、大小写字母组成,长度不超过 32 位 | 6Nf5ywUKbVaIuQ06 |
| bizConent | String(1024) | 是 | 交易信息，交易请求参数 JSON 串，具体详情参照各 Method 请求参数 | 参见请求参数样例 |
| signType | String(16) | 是 | 签名类型，固定值：HmacSHA512 | HmacSHA512 |
| sign | String(512) | 是 | 签名值，根据签名类型对请求参数的签名值 | 0A91A57735082472D25C9D... |
请求参数样例
ts
{
"merNo": "819275770875906",
"method": "basicexpay.trade.cashier",
"nonce": "SzaAcrwssP5adNZi",
"timestamp": "20230331220353",
"bizConent": "{\"merOrderNo\":\"swR75kHGS2jQYfeN\",\"clientIp\":\"127.0.0.1\",\"totalAmount\":18.37,\"currency\":\"USDT\",\"description\":\"主人何为言少钱,径须沽取对君酌\",\"orderSource\":\"APP\",\"tradeStartTime\":\"2023-03-31 22:03:53\",\"expireTime\":900,\"notifyUrl\":\"https://google.com\",\"returnUrl\":\"https://google.com\",\"attach\":\"\",\"goodsDetails\":[{\"goodsType\":\"01\",\"goodsId\":\"100001\",\"goodsName\":\"Test\",\"quantity\":1,\"price\":18.37}]}",
"signType": "HmacSHA512",
"sign": "42FEB0B73D3F79F0C8E056AEF88F5E3FA655D2AEC2AB8D561FB9EDBE85A9A872F49428BD3B327A8C3629929629D7CFF8B59736911894419A13B8970482F4E10C"
}应答参数说明
| 参数 | 类型 | 必填 | 参数说明 | 样例 |
|---|---|---|---|---|
| code | string(10) | 是 | 请求响应码 | 0000 |
| message | string(3) | 是 | 请求响应描述 | 交易成功 |
| method | string(32) | 是 | 接口名称 | basicexpay.trade.cashier |
| nonce | string(32) | 是 | 随机字符串，由数字、大小写字母组成,长度不超过 32 位 | 6Nf5ywUKbVaIuQ06 |
| timestamp | string(14) | 是 | 交易时间戳，14 位长度,格式 :yyyyMMddHHmmss | 20230217163650 |
| data | string(1024) | 否 | 交易响应信息，交易响应参数 JSON 串，code=0000 时才出现 | 参见应答参数样例 |
| signType | string(16) | 是 | 签名类型，固定值：HmacSHA512 | HmacSHA512 |
| sign | string(512) | 是 | 签名值，根据签名类型对请求参数的签名值 | 0A91A57735082472D25C9D... |
应答参数样例
ts
{
"code": "0000",
"message": "交易成功",
"method": "basicexpay.trade.cashier",
"signType": "HmacSHA512",
"sign": "0A91A57735082472D25C9D40255CA572D211AEDAC2FB2982546FE539CB90AA65F8EE2476CA42F7FD6B65BD9A92B345E3ECD1B367519041FB6DA80F9630D5291A",
"data": {"orderNo":"729352943001"...},
"nonce":"6Nf5ywUKbVaIuQ06"
"timestamp": "20230217163650"
}异步通知参数说明
商户在交易、退款、代付等场景，只要上送了异步通知地址域notifyUrl，在交易成功后会发出异步通知，通知的报文结果同“应答参数说明”，其中 data 数据域同“交易结果查询”应答参数说明数据。
商户收到异步通知后直接返回success字符串代表接收成功，若系统收到不是success，将以一定的策略重新尝试通知，商户侧需做好幂等处理。
由于同步返回的不可靠性，支付结果务必以异步通知或查询接口返回为准。