To set up a Coinom merchant and accept crypto payments, create a Coinom account, open the Merchants section, select Create New Merchant, and enter a merchant title and website URL. Next, generate your API key and connect it to an official payment plugin or your secure server-side API integration. Complete a small end-to-end test before enabling the gateway for customers.
This guide explains the entire process in practical terms. You will learn what a Coinom merchant is, how to generate and protect the API key, which integration method to choose, how a payment is verified, and what to test before launch. The setup supports websites, online stores, billing platforms, applications, SaaS products, and other custom payment workflows.
What Is a Coinom Merchant?
A Coinom merchant represents your business, website, store, or application inside Coinom. You must create one before you can generate an API key or connect a checkout. Think of it as the payment profile that links your Coinom account to a particular project.
The account and merchant serve different purposes. Your Coinom account gives you access to the dashboard. The merchant provides the credentials required by a plugin or API integration. This separation makes it easier to connect your payment project without sharing your account password.
Once connected, the Coinom Crypto Payment Gateway can create payment requests, display hosted crypto checkout, monitor supported blockchains, track confirmations, and report payment-status changes. Your website can then update the related order, invoice, download, service, or account balance.
A merchant is not the same as one individual payment. Your store uses the merchant connection to create many separate payment requests. Each purchase must still have its own order record and payment reference.
Coinom Merchant Setup at a Glance
| Step | Action | Result | Important Check |
|---|---|---|---|
| 1 | Create a Coinom account | Access to the Coinom dashboard | Use an email address you control |
| 2 | Create a merchant | A payment profile for your project | Enter a clear title and the correct website URL |
| 3 | Generate an API key | Credential for a plugin or API | Copy it immediately because it is shown once |
| 4 | Choose a plugin or API | Coinom connects to your checkout | Use a plugin for a supported platform |
| 5 | Configure payment handling | Orders and payments can be matched | Keep the API key server-side |
| 6 | Run a test payment | The full workflow is validated | Check verification and the final order status |
| 7 | Enable live checkout | Customers can pay with supported crypto | Publish clear asset, network, and refund instructions |
The account and merchant steps are simple. However, the final integration still deserves careful testing. A visible payment option does not prove that confirmation tracking, order updates, and fulfillment work correctly.
What You Need Before Setting Up a Merchant
Prepare a few items before you begin:
- An email address that your business can access
- A strong and unique account password
- A clear merchant title
- The correct URL for your website, store, or application
- Administrator access to your ecommerce or billing platform
- A developer and secure backend if you plan to use the API
- A safe place to store the API key
- A compatible wallet and small amount for final testing
Also decide whether your project follows a standard ecommerce workflow. A WooCommerce store or WHMCS installation will usually benefit from a ready-made plugin. A custom SaaS dashboard, mobile app, or Telegram bot will usually need the API.
You might be interested: What Is a Crypto Payment Gateway? Everything You Need to Know
How to Set Up a Coinom Merchant Step by Step
Step 1: Create your Coinom account
Open the official Coinom signup page. Enter your email address, choose a password, repeat it in the confirmation field, accept the privacy policy and terms, and select Sign Up.
The standard registration process uses an email address and password. Coinom does not request identity, address, or company-registration documents during this standard account setup. Use an email inbox that you monitor and protect it with appropriate security controls.
After registration, sign in with the same email address and password. You will then have access to the dashboard, but you still need to create a merchant before connecting a payment integration.
Step 2: Open the Merchants section
From the main Coinom menu, select Merchants. This page contains the payment profiles associated with your account. Select Create New Merchant to begin.
If you operate several projects, give the new merchant a title that clearly identifies its purpose. For example, “Example Store” is more useful than a generic label such as “Website.” Clear naming reduces configuration mistakes later.
Step 3: Enter the merchant title and website URL
The official setup asks for two details:
- Merchant Title: a recognizable name for the business or project
- Website URL: the address of the website connected to the merchant
Enter the real public URL for the store or application. Review it carefully for spelling mistakes and confirm that it uses the intended domain. Then select Create Merchant. The new merchant will appear in the Merchants list.
Do not invent placeholder business details for a live integration. A descriptive title and accurate URL make the dashboard easier to manage and help your team identify the correct payment profile.
Step 4: Generate the Coinom API key
Open the merchant’s information area and select Generate API Key. A side panel will open. Select Generate New API Key to create the credential.
The API key is displayed only once. Copy it before closing the panel and store it in a secure location. If you lose it, Coinom cannot display the same secret again.
The key connects the merchant to a Coinom plugin or authenticates server-side API requests. Treat it like a password. Anyone who obtains it may be able to send authenticated requests for that merchant.
Step 5: Store the API key securely
Plugin users should enter the key only in the official gateway settings inside their protected administrator area. Developers should load it from an environment variable or secret manager on the server.
Never place the API key in:
- Public frontend JavaScript
- A public Git repository
- A mobile application binary
- A Telegram message or callback value
- A screenshot, tutorial, or support post
- Application logs or analytics data
Restrict access to the team members and systems that actually need the credential. Also keep production secrets separate from development configuration.
Step 6: Choose a plugin or API integration
Your next step depends on the platform. Use a ready-made plugin when Coinom supports the ecommerce, billing, digital-download, or donation system. Choose the REST API when you have a custom website, web application, mobile application with a backend, SaaS platform, Telegram bot, or unusual fulfillment workflow.
A plugin packages the integration for a specific platform. It usually connects Coinom to existing orders or invoices with less custom code. The API gives a developer more control over the connection between payments and internal business logic.
Neither route is universally better. The right choice is the simplest one that supports your actual checkout and fulfillment requirements.
Step 7: Connect the merchant to your checkout
For a plugin, download the official integration, install it according to its documentation, and enter the Coinom API key in the gateway settings. The exact menu varies by platform, so follow the relevant Coinom installation guide.
For a custom API integration, keep the key on your server. The backend creates a payment request, stores the returned payment reference, sends the customer to Coinom checkout, receives a callback, and verifies the final payment before fulfillment.
At this point, do not enable the gateway for all customers. Complete the remaining configuration and testing steps first.
How to Accept Crypto Payments with a Coinom Plugin
The plugin route is usually the fastest option for a supported platform. Current Coinom payment plugins include:
- WooCommerce for WordPress ecommerce stores
- WHMCS for hosting, domain, server, and service invoices
- PrestaShop for PrestaShop stores
- OpenCart for OpenCart stores
- Easy Digital Downloads for downloadable products
- WordPress Donations for donation websites
The general plugin workflow is similar across platforms:
- Download the correct official plugin.
- Install and activate it through the platform’s administrator area.
- Open the Coinom gateway settings.
- Paste the API key from the correct merchant.
- Save the configuration.
- Enable Coinom as a checkout method.
- Place and pay a small test order or invoice.
- Confirm that the platform updates the related status.
Do not assume that every platform uses the same menu labels. Use the specific installation page in the Coinom documentation. You should also review plugin compatibility after a major WordPress, ecommerce, or billing-system update.
If your platform is unsupported, Coinom currently states that its team can develop a custom plugin or integration at no additional integration-development cost. Contact Coinom to confirm current availability, project scope, requirements, and timing. This offer does not remove Coinom’s normal payment-processing fee.
You might be interested: How to Accept Crypto Payments in WHMCS Without KYC
How to Accept Crypto Payments with the Coinom API
An API allows two software systems to exchange structured requests and responses. In this case, your secure backend asks Coinom to create and verify payments. The customer does not need to see or understand the API.
According to the official Coinom API Quick Start, the flow has four main stages.
1. Create an internal order
Before contacting Coinom, create an order in your own database. Store its unique ID, expected amount, product or service, customer reference, and pending status. Your system remains responsible for linking the payment to the correct purchase.
2. Create the Coinom payment
Your backend sends a POST request to https://app.coinom.com/api/v1/request. The current API requires the merchant key, amount, and callback URL. Optional fields include a return URL, description, and mobile number.
{
"merchant": "COINOM_API_KEY",
"amount": 49.99,
"description": "Order ORDER_ID",
"callbackUrl": "https://example.com/payment/callback",
"returnUrl": "https://example.com/payment/complete"
} Use obviously fictional placeholders in development examples. Never put a real API key into documentation or frontend source code.
A successful request returns result value 100 and a unique trackId. Save that trackId against the internal order before redirecting the customer.
3. Redirect the customer to hosted checkout
The documented payment-page format is https://app.coinom.com/pay/{trackId}. The customer opens this hosted checkout and chooses from the supported cryptocurrencies and networks available for the payment.
The return URL improves the customer experience after checkout, but it is not proof of payment. A customer can visit or revisit a return page without completing the correct blockchain transaction.
4. Receive the callback and verify the payment
Coinom sends an HTTP request to the callback URL after the payment status changes. Use that event to trigger server-side verification. Do not mark the order as paid merely because a callback arrived.
The backend verifies the payment with a POST request to https://app.coinom.com/api/v1/verify. The request includes the merchant API key and the saved trackId.
{
"merchant": "COINOM_API_KEY",
"trackId": "PAYMENT_TRACK_ID"
} Only treat the payment as successful when the verified result equals 100 and the returned amount matches the amount stored for the original order. Then record the reference number and fulfill the purchase.
Your fulfillment logic should be idempotent. This means repeated callbacks or status checks must not deliver the same download, credit, license, or service twice.

How Customers Pay Through Your Coinom Merchant
After the integration is complete, the customer experience follows a clear sequence:
- The customer selects Coinom or cryptocurrency at checkout.
- Your plugin or backend creates a unique payment request.
- The customer opens the hosted Coinom payment page.
- The customer selects a supported cryptocurrency and network.
- The checkout displays the amount and payment details.
- The customer sends the payment from a compatible wallet or exchange.
- Coinom monitors the blockchain and confirmation status.
- The integration receives the updated payment result.
- The website updates the related order or invoice.
Coinom currently lists Bitcoin, USDT, Ethereum, BNB, TRON, Litecoin, and Dogecoin among its supported assets. USDT is available through supported networks including TRC20, ERC20, and BEP20.
The customer must use the same asset and blockchain network shown by the payment request. For example, USDT TRC20 must be sent through TRON. An ERC20 or BEP20 transfer should not replace it simply because all three options use USDT.
You might be interested: USDT TRC20 vs ERC20 vs BEP20: Best for Crypto Payments?
Test Your Coinom Merchant Before Going Live
A complete test should cover more than opening the payment page. Use a small real-world purchase when appropriate and follow the current Coinom guidance.
- Confirm that the intended merchant is connected.
- Check that the API key was entered correctly.
- Place a new order or invoice through the normal customer flow.
- Confirm that Coinom appears as a payment option.
- Open the hosted checkout and review the amount.
- Check the available cryptocurrency and network labels.
- Complete the payment from beginning to end.
- Confirm that Coinom detects the blockchain transaction.
- Wait for the required payment status.
- Verify that the order or invoice updates correctly.
- Confirm that the payment appears in Coinom history.
- Test the customer’s return page and final message.
- For API integrations, test duplicate callbacks and retries.
- Confirm that fulfillment happens only once.
Also test an abandoned checkout. The order should remain in an appropriate unpaid or pending state, and the customer should not receive the product. Do not claim that Coinom offers a sandbox unless the current documentation explicitly confirms one.
API Key Security and Regeneration
If you lose your API key, you cannot view the same secret again. The merchant page provides a Regenerate API Key option. After confirmation, Coinom generates a new key and displays it once.
Regeneration immediately invalidates the previous API key. Therefore, plan the change carefully:
- Prepare secure access to every plugin or service that uses the old key.
- Regenerate the API key from the correct merchant.
- Copy and store the new key immediately.
- Update the key in each connected system.
- Clear caches when the platform requires it.
- Run another end-to-end test.
- Monitor the first live payments for authentication errors.
Regenerate a key if you believe it was exposed. Remove the old value from source code, screenshots, tickets, logs, deployment history, and shared documents wherever possible.
Common Coinom Merchant Setup Problems
The API key was not copied
Coinom shows the key only once. If it was lost, regenerate it from the Merchant Information section. Remember that the old key becomes invalid immediately.
The plugin reports an authentication error
Confirm that the entire API key was copied without extra spaces. Make sure the key belongs to the intended merchant. If the key was regenerated, replace the previous value in every connected plugin and application.
Coinom does not appear at checkout
Check that the plugin is installed, activated, configured, and enabled as a payment method. Review the platform-specific guide and any checkout restrictions. Clear the relevant application cache after saving settings when necessary.
The payment page opens with the wrong amount
For a plugin, review the original order and currency configuration. For an API integration, inspect the amount sent by the backend. Never accept an amount supplied directly by untrusted browser code without checking the stored order.
The customer paid, but the order did not update
Review the payment status in Coinom and inspect sanitized application logs. For an API integration, confirm that the callback URL is reachable and that the server calls the verification endpoint. Do not update the order from a screenshot.
The customer selected the wrong network
Ask for the payment reference, transaction ID, asset, network, amount, and sending time. Then contact the appropriate support channel. Recovery is not guaranteed, so clear network labels and pre-launch testing remain important.
A custom platform has no Coinom plugin
Use the API when a developer is available. You can also contact Coinom about its current custom-integration offer for unsupported websites, CMSs, ecommerce platforms, and applications.
Coinom Merchant Pricing and No-KYC Onboarding
Coinom’s standard account creation uses an email address and password without requesting identity, proof-of-address, or company documents. This can shorten the onboarding process for merchants who want to connect a crypto checkout.
“No KYC” applies to the stated standard Coinom registration process. It does not make blockchain payments anonymous. Transactions remain publicly traceable, and the customer’s wallet or exchange may apply its own verification requirements. Merchants remain responsible for the tax, accounting, consumer-protection, product, and other requirements that apply to their businesses.
The current Coinom pricing page lists a 1% processing fee for each successful payment, with no monthly or setup fee. Blockchain network fees or exchange withdrawal charges are separate and may affect the customer. Always recheck live pricing before publishing a permanent cost comparison.
You might be interested: How to Accept Crypto Payments Without KYC
Best Practices After Your Merchant Goes Live
- Keep the Coinom account email and password protected.
- Limit access to the merchant API key.
- Use HTTPS on checkout, return, and callback pages.
- Keep the CMS, ecommerce platform, and payment plugin updated.
- Verify API payments on the server before fulfillment.
- Compare the verified amount with the original order.
- Make fulfillment safe against repeated notifications.
- Keep useful payment and transaction records.
- Do not log passwords, API keys, or unnecessary customer data.
- Publish clear asset, network, cancellation, and refund instructions.
- Test the gateway again after important site or integration changes.
- Review Coinom documentation for updated currencies and features.
Customers should see a clear payment method name and understand that they will choose a cryptocurrency on the hosted checkout. Avoid promising a fixed network fee or guaranteed confirmation time because wallet, exchange, and blockchain conditions can change.
Frequently Asked Questions
How do I set up a Coinom merchant?
Create a Coinom account, open Merchants, select Create New Merchant, enter a Merchant Title and Website URL, and select Create Merchant. Then generate the API key from the Merchant Information section.
What information is required to create a Coinom merchant?
The current setup asks for a Merchant Title and Website URL. Use a clear project name and the correct public address for the website or application.
Does Coinom require merchant KYC?
Coinom’s standard registration uses an email address and password without requesting identity, address, or company documents. Merchants remain responsible for the requirements that apply to their business.
How do I generate a Coinom API key?
Open the merchant information area, select Generate API Key, and then select Generate New API Key in the side panel. Copy the key before closing the panel because it is displayed only once.
What happens if I lose my API key?
The original key cannot be displayed again. Use Regenerate API Key to create a replacement. Regeneration immediately invalidates the old key, so update every connected integration.
Can I put my Coinom API key in frontend JavaScript?
No. Keep the key in an official plugin’s protected settings or on a secure backend. Do not expose it in public code, a mobile application, repository, message, or URL.
Do I need coding knowledge to accept crypto payments?
Not necessarily. Merchants using a supported ecommerce or billing platform can install a ready-made Coinom plugin. A custom website, application, or unusual payment workflow generally requires a developer and API integration.
Which payment plugins does Coinom provide?
Coinom currently provides integrations for WooCommerce, WHMCS, PrestaShop, OpenCart, Easy Digital Downloads, and WordPress Donations.
Which cryptocurrencies can customers use?
Coinom currently lists Bitcoin, USDT, Ethereum, BNB, TRON, Litecoin, and Dogecoin. Supported USDT networks include TRC20, ERC20, and BEP20. Check the current checkout and documentation for updates.
How does a website know that a crypto payment is complete?
A plugin handles the documented payment update for its platform. With the API, a callback prompts the server to verify the trackId through Coinom. The server should require a successful result and matching amount.
Is a return-page visit proof of payment?
No. A browser redirect, return-page visit, screenshot, or customer-submitted transaction ID should not be treated as payment proof. Verify the payment through the connected Coinom workflow.
Should I test my Coinom merchant before launch?
Yes. Complete a small end-to-end test and confirm payment creation, checkout, blockchain detection, confirmation, verification, order updates, records, customer messages, and one-time fulfillment.
Start Accepting Crypto Payments with Your Coinom Merchant
Setting up a Coinom merchant is straightforward: create an account, add a merchant title and website URL, generate the API key, and connect a plugin or secure API integration. The important work comes next. Protect the key, test the full payment flow, and rely on verified payment status before fulfilling an order.
A ready-made plugin is usually the best route for a supported ecommerce or billing platform. The API is more suitable for custom websites, applications, SaaS products, Telegram bots, and workflows that connect payment to specialized business logic.
To begin, create your Coinom account, follow the official merchant and API key guide, and choose the appropriate integration. Complete a small test before accepting live crypto payments from customers.

