01
Create a payment
Send your order ID and USDT amount from your server using a site API key.
USDT · PAYMENT API
USDT Payment API for Merchants
Create a payment from your server, send the buyer to a hosted USDT checkout, and let USDTonPay handle blockchain detection and payment confirmation while the funds go directly to your merchant wallet.
Server-side API keysHosted checkoutSigned webhooks
BUILT AROUND THE ORDER
Turn a USDT transfer into a usable payment event
A wallet address alone does not tell your website which customer paid, which order should be fulfilled, or when it is safe to continue the business process.
The USDTonPay API creates a payment request linked to your order, provides the customer checkout, watches for the blockchain transfer and returns a clear payment state to your system.
CREATE PAYMENT
Start with one API request
Use a Connected Site API key from your server. The payment response includes a checkout URL that you can send the buyer to immediately.
Endpoint
POST /api/v1/paymentsAuth
Authorization: Bearer YOUR_API_KEYCurrency
USDTcurl -X POST https://usdtonpay.com/api/v1/payments \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"order_id": "ORDER-1001",
"amount": "49.90",
"currency": "USDT"
}'HOW IT WORKS
One payment flow from order creation to confirmation
Your application controls the business logic. USDTonPay handles the USDT payment layer.
02
Send the buyer to checkout
Redirect the customer to the returned hosted checkout URL with the exact payment amount and supported network.
03
USDTonPay watches the chain
The system monitors the supported blockchain network and connects the matching transfer to the payment request.
04
Your system gets the result
Receive a signed webhook after confirmation or read the payment status directly from the API.
THE PAYMENT FLOW
Your business stays in control before and after the payment
Your website or app creates the order. USDTonPay creates the USDT checkout and verifies the blockchain payment. Your system then continues fulfillment after the confirmed event.
Your Website or AppOrder · Amount · Customer
→USDTonPayCheckout · Detection · Confirmation
→Your Business LogicFulfill · Credit · Activate
CORE CAPABILITIES
The pieces a real payment workflow needs
Direct-to-wallet settlement
Customer USDT goes to the merchant wallet configured for the site instead of sitting in a USDTonPay custodial balance.
Hosted checkout included
You do not need to build QR codes, payment instructions, countdowns and payment-state UI from scratch.
Automatic payment matching
Each payment request is tied to an order so your business does not need to reconcile wallet screenshots manually.
Signed webhook events
Use the order.paid webhook to continue fulfillment, credits, membership activation or any other business workflow.
USE CASES
Use the API wherever a confirmed USDT payment should trigger something
Custom websites
Add USDT checkout to your own storefront, marketplace or order system.
SaaS & memberships
Activate plans, credits or account access after a confirmed payment.
Games & digital services
Connect USDT payments to virtual credits, digital goods or online services.
B2B & custom orders
Create payment requests from your own business workflow and receive a machine-readable result.
WEBHOOKS & STATUS
Do not make your business wait on manual wallet checks.
After blockchain confirmation, USDTonPay can send an order.paid webhook to your site. Each delivery includes an HMAC-SHA256 signature so your server can verify the raw request body before acting on the event.
You can also query the payment status directly when your application needs to read the current state.
Read the API & webhook reference →FAQ
USDT payment API questions
Does the API require USDTonPay to hold merchant funds?
No. The payment flow is designed so customer USDT is sent to the merchant wallet configured for the Connected Site rather than to a custodial USDTonPay balance.
How do I authenticate API requests?
Use the server-side API key generated for your Connected Site and send it with the Authorization: Bearer header. Keep the full key in a secure server environment and never expose it in browser code.
Do I need to build my own payment page?
No. Create Payment returns a hosted checkout URL. You can redirect the buyer there instead of building the payment instructions and payment-state interface yourself.
How does my system know the payment is complete?
You can receive a signed order.paid webhook after confirmation or query the payment status endpoint directly. Only the PAID state represents a confirmed payment.
Can I send customer and order data with the payment?
Yes. The current API supports optional customer, shipping, order note and item information in addition to the order ID and payment amount.
Related resources: read the developer documentation, compare the merchant payment gateway, explore Shopify USDT payments or review Pricing.
Create your first USDT payment.
Use your own website, your own business logic and your own merchant wallet. Add the USDT payment layer without building the blockchain monitoring stack yourself.