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. Must be included in the request header.

​
Biz-Api-Nonce
string
header
required

Timestamp. Must be included in the request header.

​
Biz-Api-Signature
string
header
required

Signature string. Must be included in the request header.

Body

application/json
  1. At least one of request_id, transaction_id, or hash must be provided by default. request_id is not applicable when the transaction type is Deposit.
  2. At least one of the remaining parameters must be provided for verification.
  3. amount_delta: amount tolerance. Default: 0.001.
  4. time: transaction time, optional, in seconds.
  5. time_type: time match type. =Created matches the transaction creation time; =Confirmed matches the confirmation time; =Completed matches the completion time. Default: Created.
  6. time_delta: time tolerance, in seconds. Default: 10.
​
request_id
string

Request ID. Not applicable for Deposit type.

Example:

""

​
transaction_id
string

Transaction ID.

Example:

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

​
hash
string

Transaction hash.

Example:

""

​
chain_id
string

Chain ID.

Example:

"TRON"

​
token_id
string

Token ID.

Example:

"TRON_USDT"

​
to
string

Recipient address.

Example:

"TWgTvxMj9AFZhQF5xKjrua(XCAnym4E1qu"

​
type
string

Transaction type. Deposit / Withdrawal.

Example:

"Deposit"

​
amount
number<float>

Transaction amount.

Example:

2000

​
fee
number<float>

Fee.

Example:

20

​
amount_actual
number<float>

Actual amount received.

Example:

1980

​
status
string

Transaction status.

Example:

"Completed"

​
amount_delta
number<float>

Amount tolerance. Default: 0.001.

Example:

0.01

​
time
integer

Transaction time. Optional, in seconds.

Example:

0

​
time_type
enum<string>
default:Created

Time match type. =Created matches the transaction creation time; =Confirmed matches the confirmation time; =Completed matches the completion time. Default: Created.

Available options:
Created,
Confirmed,
Completed
Example:

"Created"

​
time_delta
integer

Time tolerance, in seconds.

Example:

10

Response

Request succeeded. Returns the verification result and transaction details.

​
status
integer

Status code. 0 indicates success.

Example:

0

​
data
object

Per-field match results and transaction details.

​
msg
string

Error message. Present when status is non-zero.