NUSDpay provides an independent test environment (sandbox) for merchants to validate their integration before going live. The test environment is fully isolated from production and does not involve real funds.

​
Environment Information

ItemTest EnvironmentProduction Environment
API Domainhttps://apidev.nusd.mehttps://api.nusd.me
Admin ConsoleContact technical support to obtainContact technical support to obtain
The test and production environments use different API keys and wallet_id values. Do not mix them.

​
Test Flow

1

Obtain test credentials

Contact technical support to obtain the wallet_id and API key configuration for the test environment.Email: [email protected]
2

Verify the signature

Use the test keys to call any endpoint and verify that the signature flow is correct.We recommend starting with the Get Supported Chain List endpoint:
curl --request GET \
  --url https://apidev.nusd.me/nps/chains \
  --header 'BIZ-API-KEY: <your-test-api-key>' \
  --header 'Biz-Api-Nonce: <nonce>' \
  --header 'Biz-Api-Signature: <signature>'
3

Test the Payin flow

  1. Call Get Deposit Address to obtain a test address
  2. Transfer testnet tokens to that address
  3. Wait for the Webhook callback to confirm the deposit
  4. Call Transaction Records to verify the data
4

Test the Payout flow

  1. Confirm the test wallet has sufficient balance
  2. Call Initiate Withdrawal to send a test payout
  3. Wait for the Webhook callback to confirm completion
  4. Call Transaction Records to verify the data
5

Test Webhooks

  1. Configure the Webhook callback URL for the test environment
  2. Verify your signature verification logic
  3. Confirm that you respond with status code 200 or 201
  4. Test timeout and retry scenarios

​
Go-Live Checklist

Before switching to production, please confirm the following items:
API signature verification passes
Webhook callback URL is configured
Webhook signature verification logic is implemented
Webhook idempotency handling is implemented (deduplication based on request_id)
Transaction status polling fallback is implemented
Failure status handling logic is complete
Production API keys and wallet_id are configured
The API domain has been switched to api.nusd.me

​
FAQ

Rate limits in the test environment match those in production. We recommend simulating realistic call frequency during testing.
The test environment uses test networks. Transactions will be broadcast to the testnet on-chain, but they do not involve real funds.
Please contact technical support, and we will fund your test wallet with test tokens.

​
Next Steps

API Signature

Learn how the signature is calculated.

Webhook Configuration

Configure Webhooks to receive transaction notifications.