Payment Verification

How a payment is checked against the blockchain.

When a transaction hash is submitted, VerseBill reads it from the Polygon RPC and evaluates it against a strict set of rules. This happens server-side; the customer's wallet UI is not the source of truth.

What is verified

  • The transaction exists on the configured network
  • The transaction succeeded (the receipt status is success)
  • The network (chain ID) matches the invoice
  • The token contract matches the trusted VERSE contract
  • The recipient is the merchant wallet assigned to the invoice
  • The transferred amount matches the invoice total
  • The transaction has the required number of confirmations
The transfer amount is read from the ERC-20 Transfer event logs, not from a client-provided value. In production mode, 30 confirmations are required by default before an invoice is marked paid.
Payment Verification — VerseBill Documentation