64 lines
2.4 KiB
Markdown
64 lines
2.4 KiB
Markdown
接口应在服务端调用，不可在前端（小程序、网页、APP等）直接调用。具体可参考[接口接入指南](https://www.yuque.com/shunchenghuichuang/iasgxw/lw3ftk64nq0f2gsg)。
|
|
|
|
接口英文名：GetPayToken
|
|
|
|
<font style="color:rgb(34, 34, 34);">本接口用于获取获取全局唯一后台接口调用凭据token，token有效期为1个小时，开发者需要进行妥善保存，使用注意事项请参考</font>[此文档](https://www.yuque.com/shunchenghuichuang/iasgxw/lw3ftk64nq0f2gsg)。
|
|
|
|
## 1、调用方式
|
|
### HTTPS调用
|
|
`POST /api/app/backend-account/pay-token`
|
|
|
|
## 2、请求参数
|
|
### <font style="color:rgb(34, 34, 34);">请求体 </font>`<font style="color:rgb(34, 34, 34);">Request Payload</font>`
|
|
| 参数名 | 类型 | 必填 | 说明 |
|
|
| :--- | :--- | :--- | :--- |
|
|
| secretId | string | 是 | 账号的唯一凭证，需要联系财务交易中心获取 |
|
|
| secretKey | string | 是 | 唯一凭证密钥，需要联系财务交易中心获取 |
|
|
|
|
|
|
## 3、返回参数
|
|
### <font style="color:rgb(34, 34, 34);">返回体 </font>`<font style="color:rgb(34, 34, 34);">Response Payload</font>`
|
|
| 参数名 | 类型 | 说明 |
|
|
| :--- | :--- | :--- |
|
|
| respCode | string | 200是成功，其他值就是失败 |
|
|
| respMsg | string | 接口返回的信息，成功返回null |
|
|
| reqSerialNo | string | 接口请求流水号 |
|
|
| version | string | 接口版本 |
|
|
| data | string | 获取到的凭证 |
|
|
|
|
|
|
## 4、注意事项
|
|
1、secretKey是账号使用财务交易中心API接口的密钥，请开发者妥善保存，避免因泄露造成账号被他人冒用等风险。
|
|
|
|
2、获取到的凭证，过期时间是1小时，请开发者妥善保存，并定时刷新新的凭证，避免后续业务出现问题。
|
|
|
|
## 5、代码示例
|
|
请求参数：
|
|
|
|
```json
|
|
{
|
|
"secretId": "SEC-R******A",
|
|
"secretKey": "Lil7Rx**********G1UtW8"//签名时拼接使用的交易密钥
|
|
}
|
|
```
|
|
|
|
|
|
|
|
返回参数：
|
|
|
|
```json
|
|
{
|
|
"respCode": "200",//200是成功，其他值就是失败
|
|
"respMsg": null,
|
|
"reqSerialNo": "",
|
|
"version": "1.0",
|
|
"data": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJJc1BheSI6IlRydWUiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6ImQ1ZTc3MzE2LTVjNWEtNDQ3OC1iZjZhLTQ2OWU2ODNlZDMyYyIsIm5iZiI6MTc2OTIyNDI1MiwiZXhwIjoxNzY5MzEwNjUyfQ.GdL_CG0LlgOmeNtbfc5eaogpd9A73VLT5pLbWziMqKo"
|
|
}
|
|
```
|
|
|
|
<font style="color:rgb(52, 64, 84);"></font>
|
|
|
|
<font style="color:rgb(52, 64, 84);"></font>
|
|
|
|
|