Finomesh Merchant API
Finomesh is a cryptocurrency payment gateway. Your server creates a payment with your API key, your customer pays it on-chain, and your server confirms the authoritative outcome with a single verify call before fulfilling the order.
Who this is for
Backend developers integrating crypto payments into a shop, SaaS, or platform. Every call that uses your API key must originate from your server — never a browser or mobile client.
Integration options
| Option | You get | Best for |
|---|---|---|
| Hosted checkout | Finomesh renders the payment page. You redirect the customer to it and receive a callback + webhook. | Most integrations — least code, no PCI-style surface. |
| Embedded / API mode | You build your own payment UI and drive it server-to-server. IP-allowlisted. | Merchants who need the payment experience fully inside their own product. |
Both modes settle to the same payment object and use the same verify call as the source of truth.
The one rule that prevents lost money
The browser callback is forgeable and the webhook is only a trigger — neither is authoritative. Always call verify from your server before fulfilling an order. This is the single most important thing to get right.
Where to start
- Payment Flow — how a payment moves from create to verified, end to end.
- Payment Statuses — the statuses you act on, and when to fulfil.
- Quickstart — create, pay, and verify your first payment in five minutes.
- Authentication — get your API key and learn the request format.
- Environments — staging vs production base URLs.
- Sandbox Overview — exercise the full flow without real crypto.