余额转入/转出

Transfer

该API接口由MINI.GAME平台提供,由接入方进行调用

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

{MINIGAME_APIURL}为MINI.GAME接口域名,可通过后台获得

Headers

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

签名算法请查阅 签名算法及示例 页面描述

Body

Name	Type	Description
appid	string	商户的唯一标识 可通过商户后台获得
timestamp	integer	时间戳(秒)
token	string	用户在MINI.GAME平台的token,可以通过获取玩家鉴权token接口获得
currency	string	货币名称，详情查看货币列表支持的货币的name字段
amount	string (decimal)	转账的金额(最多支持4位小数) 正数加钱，负数扣钱
tx_id	string	转账的流水id，由接入方产生，必须唯一

接入方请求参数示例

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

MINI.GAME平台响应参数示例

success

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

fail

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

成功返回示例的参数说明

参数名	必选	类型	说明
data	是	object	返回的数据
tx_id	是	string	由接入方传递的流水id
ptx_id	是	string	MINI.GAME平台返回的流水id,由MINI.GAME平台产生
state	是	integer	转账状态 0:失败 1:成功 2:Pending(非1均代表失败)
code	是	integer	状态码
msg	是	string	提示信息

错误码

更多返回错误代码请查阅 通用错误码 页面描述