Get Transfer Status

The integrator calls this API to query the completion status of the transfer order.

TransferStatus

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

POST {MINIGAME_APIURL}/api/cash/v1/transfer/status?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.
tx_id	string	Transaction ID for the transfer, generated by the integrator and must be unique.

Integrator Request Parameter Example

{
    "appid": "1005",
    "timestamp": 1711954264,
    "token": "50f15a92-ee8d-11ee-9a61-00ff3fae08f7",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjcmVhdGUiOjE3MTk2Mjk2NDQsInVzZXIiOiJ7XCJpZFwiOjM1NzE0MSxcIm9wZXJhdGVyX2lkXCI6MSxcImFnZW50X2lkXCI6MTAwMDIwLFwiYXBwX2lkXCI6MTAzMSxcImFjY291bnRfdHlwZVwiOjAsXCJ2YWx1ZVwiOlwiMVwiLFwibm93X2dhbWVfaWRcIjowfSJ9.tXfaavxZu7PIedpJ5Tp7oL0aBEnb5ujok4cbKWoNj0U"
}

MINI.GAME Platform Response Parameter Example

Success

{
    "data": {
        "currency":"usdt",
        "amount": "4299.1",
        "state":1
    },
    "code": 0,
    "msg": "ok"
}

Failed

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

Response Example Parameter Descriptions

Name	Required	Type	Description
data	Yes	object	Response Data
currency	Yes	string	Currency name, for details, refer to the "name" field of the supported currencies in the currency list.
amount	Yes	decimal	Transfer amount (supports up to 4 decimal places): positive for credit, negative for debit.
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.