转账(转入/转出)
调用该接口可实现玩家的余额转入/转出，该API接口由游戏平台提供，供商户(运营商)进行调用
请求地址
POST {API_URL_ROOT}/player/transfer
Request参数
Header内容
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| sign | 是 | string | 签名，使用签名算法计算得到 |
| timestamp | 是 | int | UTC时间戳，单位秒，从1970年1月1日到现在所经过的秒数，如：1741837297 |
| Accept-Language | 是 | string | 接收的语言编码，参考语言列表，如：zh,en，以便在报错的时候，提供响应的语言错误信息。 |
| Content-Type | 是 | string | "application/json; charset=utf-8" |
| Authorization | 是 | string | JWT bearer格式token，如："Bearer TOKEN" |
BODY内容 **
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| txId | 是 | string | 交易ID，区分玩家每次转账的唯一标识，同一txId的转账只能使用一次 |
| transferType | 是 | int | 转账类型，枚举值列表见下面 |
| amount | 是 | double | 转账金额 |
注意： 如果当前账户状态异常，不能玩游戏，商户就应该卡住玩家并返回错误信息，不应该进入到此接口中
示例
{
"txId": "string",
"transferType": 1,
"amount": 0
}
Response参数
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
| txId | 是 | string | 商户交易ID, 区分不同转账动作的唯一ID |
| recordId | 是 | string | 游戏平台生成记录ID, 能够区分每次转账的唯一ID，后续查询状态会用此ID |
| status | 是 | int | 转账状态，枚举值列表见下面 |
示例
{
"isSuccess": true,
"code": 0,
"data": {
"txId": "67d3e9e9f27e66c63cc8492b",
"recordId": "67d419e4e93ccd059bb58bf5",
"status": 2
}
}
transferType 转账类型值列表
| 值 | 说明 |
|---|---|
| 1 | 转入 |
| 2 | 转出 |
transferStatus 转账状态值列表
| 值 | 说明 |
|---|---|
| 1 | 处理中 |
| 2 | 转账成功 |
| 3 | 转账失败 |