fact_check
Payment Statuses
All possible payment statuses and the end-to-end payment lifecycle.
Status Reference
| Status | Description |
|---|---|
| pending | Awaiting customer deposit |
| confirmed | Full payment received and confirmed |
| underpaid | Received amount less than expected (within tolerance) |
| overpaid | Received amount exceeds expected (within tolerance) |
| expired | 15-minute window elapsed without deposit |
| failed | System error during processing |
account_treePayment Flow
End-to-end payment lifecycle from creation to merchant balance.
shopping_cart
Step 1: Merchant creates payment
POST /payment/create → returns deposit_address and payment_id
account_balance_wallet
Step 2: Customer sends crypto
Customer transfers the coin to the deposit address within 15 minutes
search
Step 3: Blockchain monitoring
Alchemy (EVM) or polling (Tron) detects the incoming transfer
verified
Step 4: Payment confirmed
Amount verified → confirmed/underpaid/overpaid. Merchant balance credited (minus commission)
send
Step 5: Webhook & WebSocket
payment.confirmed event sent to webhook URL and broadcast via WebSocket
savings
Step 6: Merchant withdraws
Merchant requests withdrawal → platform sends to the specified address