Query Transfer Status

1. Query Transfer Status

Interface Path

• Get
• /api/wallet/check

Request Parameters

Parameter	Name	Type	Required	Description
agent_id	Merchant ID	string	Required	Merchant ID
user_id	Merchant User ID	string	Required	Merchant User ID
type	Transaction Type	string	Required	deposit: Transfer In, withdraw: Transfer Out
txn_id	Transfer Transaction ID	string	Required	Transfer In/Out Transaction ID
timestamp	Current Timestamp	int	Required	Timestamp when calling the interface (in milliseconds, valid for ten minutes)
sign	Signature	string	Required	Signature algorithm details in the interface description

Response Parameters

Parameter	Name	Type	Description
code	Response Code	int	Error Code
message	Response Message	string	Error Message
data	Response Data	dict	Response Data Details
--agent_id	Merchant ID	string	Merchant ID
--user_id	Merchant User ID	string	Merchant User ID
--txn_id	Transfer Transaction ID	string	Transfer Transaction ID
--before_balance	Member Balance Before Transfer	string	Member Balance Before Transfer
--after_balance	Member Balance After Transfer	string	Member Balance After Transfer
--currency	Currency	string	Currency
--status	Order Status	int	Order Status, 0- In Progress, 1- Success, 2- Failure

Request Example

curl --location 'https://staging.aig1234.com/api/wallet/check?agent_id=agent001&user_id=testUid03&type=deposit&txn_id=txniwsdfa342&timestamp=1732589849000&sign=8f1374b31c83ff1b60e2062897851b84' \
--header 'Content-Type: application/json'

Response Example

{
    "code": 200,
    "message": "success",
    "data": {
        "agent_id": "agent001",
        "user_id": "testUid03",
        "txn_id": "txniwsdfa342",
        "before_balance": "-0.69",
        "after_balance": "1000.00",
        "currency": "VND2",
        "status": 1
    }
}

Error Codes

200 Success
408000 Request Parameter Error
408003 Whitelist Restriction
408004 API Frequency Limit
600100 Invalid Signature
700101 Merchant Does Not Exist
700103 Member Does Not Exist
700201 Member Wallet Does Not Exist
700202 Member Wallet Type Is Not Transfer Wallet
700205 Transaction ID Does Not Exist