Transfer (In / Out)
Use this API to transfer player balance into or out of the platform wallet. Provided by the game platform; called by the merchant (operator).
Request URL
POST {API_URL_ROOT}/player/transfer
Request Parameters
Header
| Field | Required | Type | Description |
|---|---|---|---|
| sign | YES | string | Signature computed using the Signature Algorithm. |
| timestamp | YES | int | UTC timestamp seconds since 1970-01-01, e.g. 1741837297. |
| Accept-Language | YES | string | Language codes, see Language List. |
| Content-Type | YES | string | "application/json; charset=utf-8" |
| Authorization | YES | string | JWT Bearer token, e.g. "Bearer TOKEN" |
Body
| Field | Required | Type | Description |
|---|---|---|---|
| txId | YES | string | Transaction ID; unique per transfer. A txId can only be used once. |
| transferType | YES | int | Transfer type. See transferType table. |
| amount | YES | double | Transfer amount. |
Important: If the account status is abnormal and the player cannot play, the merchant should block the action and return an error BEFORE calling this API.
Example
{
"txId": "string",
"transferType": 1,
"amount": 0
}
Response Parameters
| Field | Required | Type | Description |
|---|---|---|---|
| txId | YES | string | Merchant transaction ID. |
| recordId | YES | string | Platform generated record ID used for status queries. |
| status | YES | int | Transfer status, see transferStatus table. |
Example
{
"isSuccess": true,
"code": 0,
"data": {
"txId": "67d3e9e9f27e66c63cc8492b",
"recordId": "67d419e4e93ccd059bb58bf5",
"status": 2
}
}
transferType Values
| Value | Description |
|---|---|
| 1 | In |
| 2 | Out |
transferStatus Values
| Value | Description |
|---|---|
| 1 | Processing |
| 2 | Success |
| 3 | Failed |