1
Kick-off — you
Send us your company’s legal name and a technical contact. While we do the next step, read these docs and try the endpoints in the API reference.
2
Your tenant and API key — Rampa
We create your tenant, set your pricing margin, and issue a sandbox API key over a secure channel. It is shown once — keep it server-side, never in an app or browser. See scopes.
3
Read your top-up address — you
Your Tron address is created the first time you call
GET /wallets, which returns it in top_up_addresses — there is nothing to create. Each transfer you send to it shows up as an in row in GET /wallets/transactions.4
Register your webhook — you
POST /webhooks with your URL. Store the secret from the response; you need it to verify signatures.5
Fund your wallet — you
The sandbox runs on Tron’s Shasta testnet, with the sandbox test token (contract
TYR7yDZAns63L8Cmu4EyPPxDgktq9sguvB) standing in for USDT. Get some in a wallet you control with the faucet, plus a little Shasta TRX for fees from any public Shasta faucet. Then send the tokens from that wallet to your top-up address. Once the transfer confirms on-chain it is credited automatically, and GET /wallets shows the credit. The quick start has every step.6
Your first payment — you
Get a test QR from
POST /sandbox/qr-codes, read it, quote it and pay it, following the quick start. Before you write your error handling, read the statuses and failure codes your app must handle.