Matching
A transfer from an exchange carries an address, an amount and a time. Nothing else. So VoltPay tells Checkouts apart by where the money landed and how much arrived.
Two ways
Section titled “Two ways”Two or more addresses on the Pair: a Reservation. The Checkout holds one address while it is open. The Payer sends the exact amount.
One address, or all busy: a Unique Amount. The amount is raised by less than a cent. Its third and fourth decimals, the Tag Digits, name the Checkout.
- One address carries 99 open Checkouts for each Pair. Past that:
503 PAIR_AT_CAPACITY. - Some exchanges round what a Payer types. That is why two or more addresses work better.
Timing
Section titled “Timing”- Nothing is held until needed. A Checkout takes an address when the Payer chooses how to pay.
- A Reservation lasts as long as its Checkout, 15 to 30 minutes.
- A released address rests for 5 minutes before another Checkout can take it.
How a transfer is matched
Section titled “How a transfer is matched”VoltPay tries these in order. The first that fits wins. Two Checkouts fitting at one step is no match.
| Order | Evidence | matched_by |
|---|---|---|
| 1 | The amount equals a Checkout’s amount exactly. | exact_amount |
| 2 | The address is reserved by a Checkout, and the amount is within tolerance. | reservation |
| 3 | The Tag Digits equal a Checkout’s, and the amount is within tolerance. | tag_digits |
| 4 | A Checkout expired in the last 72 hours with that amount. | late |
Tolerance
Section titled “Tolerance”- Short: by up to the Network’s shortfall allowance, and never more than 20% of the amount. It is 20 USD on Ethereum, 3 USD on TRON and 2 USD elsewhere.
- Over: by up to 10% of the amount.
Match Results
Section titled “Match Results”Every Payment and its Callback carry match_result. amount is always what truly arrived.
| Match Result | Meaning |
|---|---|
exact |
The amount asked for arrived. |
under |
Less arrived, within tolerance. The Checkout is still paid. |
over |
More arrived, within tolerance. The Checkout is still paid. |
late |
It arrived within 72 hours after expiry. expired becomes paid. |
VoltPay never asks the Payer to send the rest. What to do with under is yours to decide.
The Unmatched inbox
Section titled “The Unmatched inbox”A transfer that fits no Checkout waits in Unmatched in the Merchant Panel. The money is already in your wallet. Typical causes:
- an amount outside tolerance;
- a second payment to a Checkout that already has one;
- a payment to a saved address with no Checkout open.
An Unmatched Transfer has no Fee and sends no Callback. You can:
- Attach it to a Checkout. That creates a Payment with
matched_by: manual, charges the Fee and sends the Callback. - Dismiss it.