Balance Deposit/Withdrawal

Transfer

This API is provided by the MINI.GAME platform and is called by the integrator.

POST {MINIGAME_APIURL}/api/cash/v1/transfer?trace_id=your_trace_id

{MINIGAME_APIURL}is the MINI.GAME API domain, which can be obtained from the backend.

Headers

Name	Value
Content-Type	"application/json; charset=utf-8"
sign	"your_sign_string"

Please refer to the Signature Algorithm and Example page for details on the signature algorithm.

Body

Name	Type	Description
appid	string	The unique identifier for the merchant, available in the merchant backend.
timestamp	integer	Timestamp (in seconds)
token	string	The user's token on the MINI.GAME platform can be obtained through the Get User Game Token API.
currency	string	Currency name, for details, refer to the "name" field of the supported currencies in the currency list.
amount	string (decimal)	Transfer amount (supports up to 4 decimal places): positive for credit, negative for debit.
tx_id	string	Transaction ID for the transfer, generated by the integrator and must be unique.

Integrator Request Parameter Example

{
    "appid": "13",
    "timestamp": 1711954264,
    "token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjcmVhdGUiOjE3MTk2Mjk2NDQsInVzZXIiOiJ7XCJpZFwiOjM1NzE0MSxcIm9wZXJhdGVyX2lkXCI6MSxcImFnZW50X2lkXCI6MTAwMDIwLFwiYXBwX2lkXCI6MTAzMSxcImFjY291bnRfdHlwZVwiOjAsXCJ2YWx1ZVwiOlwiMVwiLFwibm93X2dhbWVfaWRcIjowfSJ9.tXfaavxZu7PIedpJ5Tp7oL0aBEnb5ujok4cbKWoNj0U",
    "currency":"usdt",
    "amount":"1000.01",
    "tx_id":"etx0917yn"
}

MINI.GAME Platform Response Parameter Example

Success

{
    "data": {
        "tx_id":"etx0917yn",
        "ptx_id":"1024",
        "state":1
    },
    "code": 0,
    "msg": "ok"
}

Failed

{
    "code": 10002,
    "msg": "sign invalid"
}

Response Example Parameter Descriptions

Parameter	Required	Type	Description
data	Yes	object	Response Data
tx_id	Yes	string	Transaction ID provided by the integrator.
ptx_id	Yes	string	Transaction ID returned by the MINI.GAME platform, generated by theMINI.GAME platform.
state	Yes	integer	Transfer Status 0: Failed, 1: Successful, 2: Pending
code	Yes	integer	Status Code
msg	Yes	string	Prompt message

Error Code

For more error codes, please refer to the General Error Codes page description.