Contact us and create an account
Before using any API, you need to contact us to create an account and obtain a
wallet_id.- Send an email to [email protected] with your company/project name, contact information, and a brief description of your business scenario
- We will create a wallet for you, bind your project information, and assign administrator permissions
- Once complete, you will receive a dedicated
wallet_id
Generate API keys
After obtaining your
wallet_id, generate an API key pair for interface authentication.- Follow the instructions to generate an Ed25519 key pair (the public key serves as
API_KEY, the private key asAPI_SECRET) - Provide the public key to us for binding
Platform configuration
Based on your business needs, confirm the following configuration items:Chains and tokens — Select the chains and tokens to enable. See Supported Tokens and Chains.Webhook callback — Provide a callback URL to receive transaction status updates in real time. See Webhook Overview.Payout configuration — If you need the payout function, confirm that Payout permissions are enabled for the relevant chain.
Understand the request specification
Before calling the interfaces, please read the following:
Request Specification
Request headers and authentication
API Signature
Signature calculation method
Transaction Status
Meaning and transitions of each status
Error Codes
Error codes and troubleshooting guide
Integration development
After completing the preparations above, choose the corresponding module based on your business scenario:
Main interfaces:
Payin (Deposit)
- Get Deposit Address — Generate a dedicated deposit address for each end user
- Query Wallet Balance — Query the current NUSD balance
- Deposit Callback — Receive deposit notifications
Payout (Withdrawal)
Main interfaces:- Query Platform Fees — Query the current fee configuration
- Initiate Withdrawal — Send a payout to the end user’s wallet address
- Query Withdrawal Records — Query payout status
- Withdrawal Callback — Receive payout result notifications
Checkout (Optional)
If you want to provide a ready-made payment page to end users, you can integrate the Checkout H5 page. See Integrate H5 Page.If you only use the API for wallet management and asset operations and do not need to integrate Checkout, you can skip this section.
Next Steps
Product Overview
Learn about the full capabilities of NUSDpay.
Sandbox Testing
Validate your integration in the test environment.