Cryptomus acquiring allows you to accept payments in cryptocurrency, and the client to pay either with cryptocurrency or a bank card. The service itself has a user-friendly interface for work, and there are more than 30 cryptocurrencies to choose from. Suitable for both business and personal use.
Unlike bank acquiring, cryptocurrency acquiring is a little more complicated, has more parameters for paying the bill, statuses and is less automated in terms of controlling amounts. Therefore, let's take a detailed look at how to work with Cryptomus and how to set up this payment module for the JoomShopping store.
Registration and creation of a merchant
- Register on Cryptomus.
- Log in to your account and go to the Business section -> Merchants.
- Click "Create a merchant" and follow the instructions.
Instructions from the service here.
Installation
Installation is performed through the Joomla installer. After that, the corresponding method with standard configurations will appear in the JoomShopping payment methods. Change it to suit your needs.
After installation, in the section "Extensions -> Update servers -> Cryptomus for JoomShopping" enter the update key that will be provided to you after purchase.
Payment settings
To pull up the configurations and payment logic to another payment method, insert the value pm_cryptomus into the "Alias" field and save the payment. Or edit the method created during the module installation.
After confirming the merchant, go to its settings. There you will need the "Merchant ID" and "Payment API key".
Please note! Cryptomus does not have test keys, settings or endpoints, so testing should be done carefully and with a controlled order amount.
Paste the "Merchant ID" and "Payment API key" from the merchant settings into the corresponding fields of the Cryptomus payment method configuration for JoomShopping.
Value of other parameters
- Invoice lifetime in seconds. Value from 300 to 43200. The validity period of the issued invoice (in seconds). After this time, the invoice is closed fully or partially unpaid. If there was an incomplete payment, the service gives another 4 hours to close the invoice. It is recommended not to specify this value below 7200 (2 hours).
- The percentage of the payment commission charged to the client. Each merchant has its own commission rate. By default, it is 2% and is charged to a business client. If you want the client to pay a commission, set the value to 100. To split it in half, set it to 50.
- Permissible payment inaccuracy in percentage. The value is from 0 to 5. For example, if you specify 5, then invoices paid by 95% or more will be marked as successfully closed.
- Currency. Here you can specify in which currency the client can pay. Only one - specify or select (you can specify a specific one by specifying the code and network, or just the code, if it is USDT, etc.). Several specific ones - select specific ones. The selection list is pulled from Cryptomus when the merchant ID and key are specified.
- Source of exchange rate. The service from which the exchange rates will be taken for recalculation in the invoice.
- Additional information for you. Short information that will be visible only to you in the business account. Up to 255 characters.
- Return option. Yes - you can make full returns (partial returns are not supported) through the admin panel on the order page, specifying the wallet address. No - you can't.
- The return commission is paid by. Who pays the fee for manual returns.
- Automatic refund for partial payment. Yes - if the account was not fully closed 4 hours after the first payment, the funds will be automatically returned, but minus the network fee. Important! If the payment was not made in full, but you agreed with the client directly, in the Cryptomus business account in the merchant payments section you must open the payment and manually confirm it, otherwise the funds will be returned to the client!
- Automatic return of funds blocked by the AML program. Transactions from sanctioned and suspicious wallets will not pass the AML check in any case. But in order not to manually return funds to the buyer, you can set this option. Upon receipt of the "locked" status from Cryptomus, a refund will be issued minus the network commission.
Incompletely paid orders
If the "wrong_amount_waiting" status is received and the buyer returns, the order will be created, but he will be shown a message with the balance and wallet for the transfer. The client will have 4 hours to close the account, otherwise the status "wrong_amount" will be received and the account will be closed. The link to the payment page will be added to the variable "_tmp_html_after_total» and a new variable "order->payment_url" was created, which can be separately displayed in the template on the full order information page.
With the "wrong_amount" status and the "Automatic refund for partial payment" option selected, the funds will be returned to the buyer automatically.
Please note that if the receipt was less than the minimum for a specific cryptocurrency, these kopecks will not be recognized by the service in any way. For example, the minimum amount in USDT is 1. If 0.99 was received, they will not be taken into account and a refund will not be possible.
Other nuances
Crediting to a Cryptomus business account occurs in the cryptocurrency selected by the buyer, even if the invoice is generated in fiat. The rate source can be selected in the JoomShopping payment parameters. You can set up automatic conversion to USDT in the merchant settings.
