hfb_sys/docs/顺成汇创交易中心聚合支付/2.获取接口调用凭据 copy.md

接口应在服务端调用，不可在前端（小程序、网页、APP等）直接调用。具体可参考接口接入指南。

接口英文名：GetPayToken

本接口用于获取获取全局唯一后台接口调用凭据token，token有效期为1个小时，开发者需要进行妥善保存，使用注意事项请参考此文档。

1、调用方式

HTTPS调用

POST /api/app/backend-account/pay-token

2、请求参数

请求体 <font style="color:rgb(34, 34, 34);">Request Payload</font>

参数名	类型	必填	说明
secretId	string	是	账号的唯一凭证，需要联系财务交易中心获取
secretKey	string	是	唯一凭证密钥，需要联系财务交易中心获取

3、返回参数

返回体 <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、代码示例

请求参数：

{
"secretId": "SEC-R******A",
"secretKey": "Lil7Rx**********G1UtW8"//签名时拼接使用的交易密钥
}

返回参数：

{
"respCode": "200",//200是成功，其他值就是失败
"respMsg": null,
"reqSerialNo": "",
"version": "1.0",
"data": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJJc1BheSI6IlRydWUiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6ImQ1ZTc3MzE2LTVjNWEtNDQ3OC1iZjZhLTQ2OWU2ODNlZDMyYyIsIm5iZiI6MTc2OTIyNDI1MiwiZXhwIjoxNzY5MzEwNjUyfQ.GdL_CG0LlgOmeNtbfc5eaogpd9A73VLT5pLbWziMqKo"
}