接口应在服务端调用,不可在前端(小程序、网页、APP等)直接调用。具体可参考[接口接入指南](https://www.yuque.com/shunchenghuichuang/iasgxw/lw3ftk64nq0f2gsg)。
接口英文名:GetPayToken
本接口用于获取获取全局唯一后台接口调用凭据token,token有效期为1个小时,开发者需要进行妥善保存,使用注意事项请参考[此文档](https://www.yuque.com/shunchenghuichuang/iasgxw/lw3ftk64nq0f2gsg)。
## 1、调用方式
### HTTPS调用
`POST /api/app/backend-account/pay-token`
## 2、请求参数
### 请求体 `Request Payload`
| 参数名 | 类型 | 必填 | 说明 |
| :--- | :--- | :--- | :--- |
| secretId | string | 是 | 账号的唯一凭证,需要联系财务交易中心获取 |
| secretKey | string | 是 | 唯一凭证密钥,需要联系财务交易中心获取 |
## 3、返回参数
### 返回体 `Response Payload`
| 参数名 | 类型 | 说明 |
| :--- | :--- | :--- |
| 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"
}
```