Documentation
Introduction
Paysover is neither a payment system nor a wallet. In order to connect, you must already have wallets to which you will be receiving payments. Create these through MetaMask, Trust Wallet, Exodus Wallet, etc. The service enables receipt of payments even to cold wallets; nothing is required except the wallet address.
Merchants
A merchant is required for logical organization of wallets. An API key tied to the merchant is to be specified when sending requests to the service. All wallets are added to the merchant, hence it is necessary to create the merchant first.
Name - any desired name can be input, for example, the website address or the project name.
Type of Conversion - depending on the currency you accept, there are three types of conversions.
1. Base - no conversion, cryptocurrency is received as cryptocurrency. Suitable when your website prices are stated in cryptocurrency, not fiat.
2. Fixed - allows you to independently set any conversion rate. This provides the possibility of accepting some form of your own, internal currency (credits, points, etc.) without a direct tie to actual existing rates. Or, if you want to accept cryptocurrency at your own, unique rate.
3. Dynamic - automatic conversion at the official rate. Suitable for most situations. For example, your website prices are in USD, a client pays 10 dollars in LTC. At the time of creating the transaction, 10 dollars will be automatically converted to LTC at the current rate. As a result, the sum in LTC that the client must pay will be calculated.
Response type - there are two methods of connection when creating a merchant. They determine how the transaction status will be transmitted.
1. API - you send a request to receive the transaction status.
2. Web Hook - we will send a notification when the transaction status changes.
You need to clarify with your programmer which specific method is more suitable in your case.
API allows you to receive more information about the transaction and do it more frequently.
Web Hook is simpler to connect.
Currency - depending on the chosen conversion type, you need to select or specify the base currency (that is accepted on your website).
After creating the merchant, you can click on "More" to see the API key of this merchant. Merchant settings can be edited at any time.
Wallets
If a merchant is already established, wallets can be added to it. This can be achieved in two ways: individually or in bulk. The corresponding buttons can be found at the top of the wallets page.
Adding a Single Wallet
Select a merchant - choose from the list of existing merchants.
Exchange rate - if a merchant with a fixed conversion type is selected, you will see this field where you need to specify the conversion rate.
Network - choose the network from the available list.
Cryptocurrency - choose the cryptocurrency from the available list.
Address - wallet address. Ensure that the address corresponds to the chosen network.
Transaction confirmation number - it's recommended to keep the default. Having too few confirmations is unsafe, while too many can extend the time required for transaction confirmation.
Transaction lifetime - this determines the timeframe given to the user to complete the payment.
Adding Wallets in Bulk
Select a merchant - choose from the list of existing merchants.
Network - choose the network from the available list.
Address - wallet address. Ensure that the address corresponds to the chosen network.
One wallet address will be added for all chosen cryptocurrencies on this network.
Transactions
In addition to transmitting the transaction status to you via API, all transactions will also be displayed on this page.
To verify the correctness of the connection, initiate a transaction. If it appears on the page, it means all data was transferred correctly and the transaction status will be available to you according to the chosen method.
If a transaction appears but you do not receive its status, ensure the transaction status receipt was properly implemented according to the selected method.
Integration
Users can make payments without the need to navigate away to a third-party website. All the requisite operations take place seamlessly within your website or application. The fundamental procedure for establishing a connection can be understood through the following steps:
1. To begin, you must add the wallets that will receive payments to your platform. Each wallet should be registered using a specific format: Network/Coin/Address. This will allow for the correct processing of payments.
2. When a transaction is being initiated (such as when a user clicks the “Pay” button), you must send us a specific request. This request should contain the following details: the amount to be transacted, the network, and the coin. Note that the amount should be expressed in the currency of your platform (the merchant's currency) which will then be automatically converted into the corresponding cryptocurrency, based on the merchant's settings. The information about the network and coin must adhere to the following structure: https://paysover.com/api
3. After we receive your request, we will respond with two important pieces of information: the amount of time left for the transaction to be completed and the amount due in the chosen cryptocurrency. This is the amount the user is required to pay.
4. You must then display this information to the user, together with the wallet address that will receive the payment. This information allows the user to successfully complete their payment.
5. After the payment has been made, you can check the status of the transaction. Depending on your platform's settings, you may either manually inquire about the transaction status using the API at regular intervals, or receive automatic updates through a Web Hook.
For further guidance, please refer to our API documentation available at: https://paysover.com/api