TRADOM Payment
Developer guides for accepting stablecoin payments in your online store
TRADOM Payment lets you accept USDC and USDT payments from your customers. Specify prices in JPY or USD, then use the API to manage checkout, payment confirmation, and refunds.
Choose an integration
| Hosted Checkout | Custom Payment Flow | |
|---|---|---|
| Recommended for | Most online stores | Businesses that need a custom UI |
| You build | Order creation and a redirect | The payment UI and state handling |
| Customer experience | Hosted by TRADOM Payment | Built and hosted by you |
| Authentication | Gateway key gw_live_… | Secret key sk_test_… / sk_live_… |
| Start here | Hosted Checkout quickstart | Custom Payment Flow |
Choose Hosted Checkout unless you need a custom payment experience. It handles asset and network selection, QR codes, and payment confirmation for you.
How Hosted Checkout works
1. Create a checkout from your backend
2. Redirect the customer to checkoutUrl
3. The customer sends USDC or USDT
4. Confirm the payment from your backend
5. Fulfil the orderFollow the quickstart to create your first checkout.
Before you begin
- A TRADOM Payment merchant account
- A Gateway API key stored on your server
- A
returnUrlfor customers to return to after payment - Node.js 18 or later and npm
Never expose a Gateway key, secret key, or webhook secret in the browser. Use the SDK only from your backend.
Integration checklist
- Create your first checkout with the Hosted Checkout quickstart
- Test without moving funds using test mode
- Receive asynchronous payment updates with webhooks
- Add refunds
For lower-level details, see the TypeScript SDK and API objects.