Invoices and Payment Rules
How Zyrox prices an invoice, decides when it is paid, and what happens when a customer sends too little, too much or too late.
Price and Quote
- You set the price in USD: in the payment link (
amount) or in an API checkout session. - The customer picks a token and network at checkout.
- Zyrox converts the USD price at the current rate into an exact token amount and reserves a unique receiving address for this invoice.
- The quote and the address are held for 60 minutes. After that the customer gets a new quote at the current rate.
Each invoice gets its own address derived from your xPub, so a payment is matched to the invoice by the address it was sent to.
When an Invoice Is Paid
| Received on the invoice address | Status |
|---|---|
| At least the quoted token amount | Paid |
| Less, but within the tolerance in USD | Paid |
| Less than the tolerance allows | Underpaid |
| More than the tolerance allows | Overpaid |
- The tolerance is a small USD margin for rate and rounding differences, 0.5% by default.
- A payment counts after the network's required number of confirmations. Zyrox watches new blocks every few seconds.
- With the Stripe-compatible API,
checkout.session.completedis sent only when the invoice is Paid or Overpaid.
Partial and Late Payments
- Partial payment: an Underpaid invoice stays open and keeps its address. If the customer sends the rest to the same address and the total reaches the quoted amount, the invoice becomes Paid.
- Late payment: a transfer confirmed after the 60-minute quote window is not credited to the invoice automatically by default. It still reaches your wallet, because the address is yours.
What to Do in Each Case
| Situation | What happens | What the merchant does |
|---|---|---|
| Paid | Order complete, webhooks and callbacks sent | Deliver the order |
| Underpaid | Invoice stays open | Wait for the customer to send the rest, or agree on a refund of what was received |
| Overpaid | Order complete | Deliver; refund the difference from your wallet if you choose |
| Paid after the quote expired | Not credited automatically | Find the transaction in the dashboard or block explorer, then deliver manually or refund |
| Sent the wrong token or network | Not matched to the invoice | Contact Zyrox support with the transaction ID |
Refunds and Chargebacks
On-chain transfers are final, so there are no chargebacks. A refund is a separate transfer you send from your own wallet; Zyrox cannot reverse a payment.
Where to Check
- Dashboard: invoices and payments with their statuses
- Merchants → [merchant] → Integration Logs: every callback and its response
- Block explorer links: available for every transaction ID
© 2026 Zyrox. Simple and secure crypto payment processing.