Merchant API
Merchant integration standards, security rules, and operational guidance.
Everything a business needs to accept payments through Solmonto: authentication, payments and payment links, webhooks, reconciliation and key security.
The full API reference and your sandbox and live keys are in your Solmonto workspace. The standards below apply to every integration.
Your API keys are in your Solmonto profile.
No separate merchant profile is needed: create a regular profile and generate sandbox and live keys in your workspace.
Merchant API Overview
Solmonto lets businesses accept payments through API integrations, payment links and lightweight checkout widgets, with crypto payment invoice processing, unified analytics across several websites and automated payment confirmation and payouts.
Build and test against the sandbox first, then switch to live keys when you are ready. One workspace can serve several websites, each with its own API keys and one unified view of all activity.
Authentication, Access Control & Key Security
Businesses using API integrations are responsible for securing their operational API tokens, configuring IP whitelists, and managing access permissions inside their own infrastructure. API credentials should remain server-side only and must never be embedded directly in public frontend code or client applications.
A correct deployment model uses a backend-owned integration layer that stores secrets securely, authorizes requests to Solmonto endpoints, validates callback signatures, and limits internal access by role. Teams should also prepare for key rotation and environment separation between testing and live operations.
Payments, Payment Links & Multi-Site Operations
Structure your integration around payment creation, hosted or embedded checkout, invoice-style payment links and your own order mapping. One workspace can run several websites, issue several API keys and track everything in one place.
Teams preparing for integration should design around deterministic order identifiers, internal idempotency, duplicate event protection, and clean mapping between merchant order references and Solmonto-side payment records. This becomes especially important when confirmations and settlement updates arrive asynchronously.
Webhooks, Callbacks & Reconciliation
Verify every incoming payment notification before your systems act on it, and log each event with its original payload, delivery state and processing result.
Operational reconciliation should preserve event identifiers, payment identifiers, merchant references, and settlement references so finance and support teams can rebuild the full transaction trail. Idempotent event processing is strongly recommended to avoid duplicate order updates, repeated balance changes, or incorrect customer notifications.
Fees, Settlement Logic & Payout Operations
API access, gateway integration, payment links, invoices, webhooks and the sandbox come free with your regular Solmonto profile — there is no separate merchant profile. You pay 0.50% on each successful payment and 0.50% on each successful mass payout.
Fees apply only to successful transactions, never to onboarding or API activation. The full schedule is in Rates & Fees.
Merchant Responsibility, Compliance & Dispute Scope
Solmonto operates as a technical gateway and software middleware provider. Merchants remain fully responsible for the goods, services, subscriptions, or digital products they sell through API-connected payment flows. The platform does not act as an escrow provider, buyer-protection authority, or dispute resolution layer for third-party merchant activity.
Users who pay merchants through Solmonto do so under the merchant’s own commercial responsibility. Merchants integrating the API should therefore maintain their own customer service, refund logic, legal disclosures, compliance checks, and post-payment support procedures within their own business environment.
Support Coverage & Integration Readiness
Our business desk handles API keys and authorisation, setup, webhook issues, mass payouts, payroll API and merchant balance settlement.
When you contact support, choose the business department and include your workspace ID and, for payment issues, the transaction hash.
Explore the Solmonto ecosystem