会员转入
1、会员转入
接口路径
- POST
- /api/wallet/deposit
说明
- 会员转入，状态出现网络问题失败，或是 Pending 中，请 10 秒后通过查询转账接口确认转账状态。
- 金额精度：
USD: 2
VND: 2
VND2: 2
BRL: 2
请求参数
| 参数 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| agent_id | 商户 ID | string | 必填 | 商户 ID |
| user_id | 商户侧用户 ID | string | 必填 | 商户侧用户ID, 字符串长度最小3，最大20, 只支持英文、数字以及_ |
| txn_id | 商户端生成的交易 ID | string | 必填 | 商户端生成的交易 ID，请确保全局唯一，字符串长度最小3，最大32 |
| amount | 转入金额 | string | 必填 | 转入金额 |
| currency | 币种 | string | 必填 | 币种 |
| timestamp | 当前时间戳 | int | 必填 | 传调用接口时的时间戳（单位毫秒，有效期十分钟） |
| sign | 签名 | string | 必填 | 签名算法详见接口说明 |
响应参数
| 参数 | 名称 | 类型 | 说明 |
|---|---|---|---|
| code | 响应码 | int | 错误码 |
| message | 响应信息 | string | 错误信息 |
| data | 响应数据 | dict | 响应数据详情 |
| --txn_id | 会员转入交易 ID | string | 会员转入交易 ID |
请求范例
curl --location 'https://staging.aig1234.com/api/wallet/deposit' \
--header 'Content-Type: application/json' \
--data '{
"agent_id": "agent001",
"user_id": "testUid03",
"txn_id": "txniwsdfa342",
"amount": "1000.69",
"currency": "VND2",
"timestamp": 1732589849000,
"sign": "6d39491fb4195d392dc3d53bf6c88138"
}'
响应范例
{
"code": 200,
"message": "success",
"data": {
"txn_id": "txniwsdfa342"
}
}
错误码
200 成功
408000 请求参数错误
408003 白名单限制
408004 API频率限制
600100 签名不合法
700101 商户不存在
700103 会员不存在
700201 会员钱包不存在
700202 会员钱包类型不是转账钱包
700203 转入金额参数不合法
700204 会员转入失败
700208 币种错误
700209 交易ID已存在