Skip to content

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 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.
  • 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.

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
  • 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.

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.

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.