POST
/
nps
/
bill
/
verify
/
tx
cURL
curl --request POST \
  --url https://apidev.nusd.me/nps/bill/verify/tx \
  --header 'BIZ-API-KEY: <api-key>' \
  --header 'Biz-Api-Nonce: <api-key>' \
  --header 'Biz-Api-Signature: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "request_id": "",
  "transaction_id": "da55a74c-e666-428d-8227-38cd25e3414d",
  "hash": "",
  "chain_id": "TRON",
  "token_id": "TRON_USDT",
  "to": "TWgTvxMj9AFZhQF5xKjrua(XCAnym4E1qu",
  "type": "Deposit",
  "amount": 2000,
  "fee": 20,
  "amount_actual": 1980,
  "status": "Completed",
  "amount_delta": 0.01,
  "time": 0,
  "time_type": "Created",
  "time_delta": 10
}
'
{
  "status": 0,
  "data": {
    "chain_id_match": true,
    "token_id_match": true,
    "to_match": true,
    "status_match": true,
    "type_match": true,
    "amount_match": true,
    "fee_match": true,
    "amount_actual_match": true,
    "time_match": true,
    "result": true,
    "data": {
      "wallet_id": "b2c13dba-7787-4db5-98e3-cff374dc04cd",
      "type": "Deposit",
      "status": "Completed",
      "amount": "2000",
      "to": "TWaQTxMj9AFZHuf5XKjuaXCXAhym4Eiqu",
      "fee_ratio": "0.01",
      "fee_fixed": "0.00",
      "fee": "20",
      "er": "1",
      "amount_actual": "1980",
      "hash": "c4caed59a0dec787fca9c8f24555ece92dd6cb235f54595f11e9a409b318f31",
      "chain_id": "TRON",
      "token_id": "TRON_USDT",
      "created_at": "2025-10-26T22:46:55.268Z",
      "confirmed_at": "2025-10-26T22:47:50.847Z",
      "completed_at": "2025-10-26T22:47:50.847Z"
    }
  },
  "msg": "<string>"
}

Authorizations

​
BIZ-API-KEY
string
header
required

API Key，请求需在请求头中携带。

​
Biz-Api-Nonce
string
header
required

时间戳，请求需在请求头中携带。

​
Biz-Api-Signature
string
header
required

签名串，请求需在请求头中携带。

Body

application/json
  1. request_id、transaction_id、hash 默认至少使用一个参数，其中交易类型为 Deposit 时，request_id 不适用
  2. 剩余参数需至少提供一个进行校验
  3. amount_delta：数量容差，默认：0.001
  4. time：交易时间可选，单位：秒
  5. time_type：时间匹配类型：=Created，按交易的创建时间；=Confirmed，按交易的确认时间；=Completed，按交易的完成时间，默认：Created
  6. time_delta：时间容差，单位：秒，默认：10
​
request_id
string

请求 id，Deposit 类型不适用

Example:

""

​
transaction_id
string

交易 id

Example:

"da55a74c-e666-428d-8227-38cd25e3414d"

​
hash
string

交易哈希

Example:

""

​
chain_id
string

链 id

Example:

"TRON"

​
token_id
string

币种 id

Example:

"TRON_USDT"

​
to
string

收款地址

Example:

"TWgTvxMj9AFZhQF5xKjrua(XCAnym4E1qu"

​
type
string

交易类型，Deposit / Withdrawal

Example:

"Deposit"

​
amount
number<float>

交易数量

Example:

2000

​
fee
number<float>

手续费

Example:

20

​
amount_actual
number<float>

实际到账数量

Example:

1980

​
status
string

交易状态

Example:

"Completed"

​
amount_delta
number<float>

数量容差，默认：0.001

Example:

0.01

​
time
integer

交易时间，可选，单位：秒

Example:

0

​
time_type
enum<string>
default:Created

时间匹配类型：=Created 按交易的创建时间；=Confirmed 按交易的确认时间；=Completed 按交易的完成时间，默认：Created

Available options:
Created,
Confirmed,
Completed
Example:

"Created"

​
time_delta
integer

时间容差，单位：秒

Example:

10

Response

请求成功，返回校验结果与交易详情

​
status
integer

状态码，0 表示成功。

Example:

0

​
data
object

字段匹配结果及交易详情

​
msg
string

错误消息，status 非 0 时存在