Crypto Payment Detection

Overview

What it means

Crypto payment detection is recognizing blockchain activity that might satisfy a particular payment request. It is an observation and matching step, not the final decision to treat an invoice as paid.

How it works

Monitors follow relevant addresses, token contract events and chain data; they normalize values and compare destination, chain, token, amount and permitted payment window with saved invoices. Candidate matches receive a unique event identity, status and confidence level. Subsequent confirmation tracking establishes whether the observed activity remains valid.

Understanding the technical details

A reliable detector uses a compound match: chain, asset or contract, recipient, required memo, credited amount and allowed time window. Every event should have a stable identity so retried node polling and duplicate webhook delivery cannot inflate the invoice balance. For chains with reorganizations, detection records should remain revisable until the merchant finality rule is satisfied. Keep the distinction visible to customers: detecting a transaction begins verification; it does not grant immediate entitlement.

Common failures and limitations

Address-only matching can mix funds from different customers. Fake tokens can share a trusted token symbol. Reorgs, duplicate provider events and missing memos can produce false positives unless the monitor validates full transfer context.

Related concepts

Crypto Invoice, Crypto Checkout, Crypto Payment Link.

Further reading

OxaPay — Integration documentation.