Hosted Mode
The hosted mode is the quickest method to add coinmena support to your app.
Coinmena integration
Simple Integration(coinmena)
Integrating in hosted mode is pretty straight forward, the only thing you would need to do is redirect your user to onramp (link below), this would work for both on desktop and mobile, just add a link to your app.
https://integration.coinmena.com/app/?appId=1
Customisation (coinmena)
If you want to set some custom options for your integration, just add them as query parameters to the URL.
For example, let's set a walletAddress
param so that it'll be pre-filled for the user, for detailed customisation refer to the block below.
Customisation options via query params
GET
https://integration.coinmena.com/app/?appId=1
User is redirected to the coinmena site, with configs set in query params.
Path Parameters
Name | Type | Description |
---|---|---|
coinAmount | 10 | amount denoted in the native coin/token. either coinAmount or fiatAmount, can be passed. When passed both coinAmount takes precedence |
network | bep20 | supported networks by coinmena for onchain transactions current supported networks: usdt - bep20 | matic20 | erc20 | trc20 usdc - bep20 | matic20 busd - bep20 matic - matic20 bnb - bep20 eth - erc20 | matic20 |
fiatAmount | 1000 | amount denoted in fiat amount. (only ₹ INR is currently supported) |
coinCode | usdt | Name of the coin (also denoted as key in data.allCoinConfig in the response returned in the allConfig endpoint) current supported coins: usdt| usdc | busd | eth | bnb | matic | sol |
appId* | 1 | App Id of the merchant/Partner |
walletAddress | 0x7c8D..596 | Onchain wallet address to which the crypto will be withdrawn to. |
merchantRecognitionId | 13422 | Specific string that can be passed by the merchant/Partner at the time of making the request, this would reflect via update from webhook. |
paymentMethod | 1 | Type of method the user would choose to pay in. 1 -> Instant transfer (e.g. UPI) 2 -> Bank transfer (e.g. IMPS/FAST) |
redirectUrl | coinmena-example.com | URL to which the user would be redirected after a successful transaction.* *Applicable only in hosted mode |
addressTag | 334552 | memo/tag associated with the transaction can be useful for certain cryptocurrencies that require this information to identify the recipient of a transaction or deposit. E.g. XRP, XLM etc |
fiatType | 1 | 1 -> India (Default) INR 2 -> Turkey (TRY) 3 -> Arab Emirates Dirham (AED) 4 -> Mexican Peso (MXN) 5 -> Vietnamese dong (VND) 6 -> Nigerian Naira (NGN) etc Note: For a complete list of supported fiat currencies, please visit the "Fiat Currencies" page under "Supported Assets & Fiat" |
phoneNumber | %2B90-9993749865 | The user's phone number should be URL-encoded, with the country code and phone number separated by a hyphen. e.g. the number +90-9993749865 would be encoded as %2B90-9993749865. |
lang | en|vi|es|tr | lang feature is available.. please set it using queryParam en -> 'English', (default) tr -> 'Türkçe', vi -> 'Tiếng Việt', es -> 'Español', pt -> 'Portuguese', fil -> 'Filipino', th -> 'Thai', sw -> 'Swahili', id -> 'Indonesian', |
Integrating in hosted mode is pretty straight forward, the only thing you would need to do is redirect your user to CoinMena (link below), this would work for both on desktop and mobile, just add a link to your app.
This method is designed to streamline the payment process within applications by allowing certain parameters to be pre-filled. This pre-filling of parameters enables users to be redirected directly to the payment confirmation page, thus enhancing the user experience by removing unnecessary steps.
Example url
The parameters that can be pre-filled are:
appId
: The application ID that is unique to the client's application.walletAddress
: The user's wallet address where they will receive the cryptocurrency.coinCode
: The code of the cryptocurrency to be purchased (in this case, USDT).network
: The blockchain network on which the transaction will occur (in this case, MATIC20).fiatAmount
: The amount of fiat currency (in this case, INR) that the user is spending.fiatType
: The type of fiat currency being used. (in this case 1 -> INR).paymentMethod
: The payment method chosen by the user. (in this case 1 -> UPI).
By customising the URL with these parameters, CoinMena provides a seamless experience where the user is taken directly to the payment page with all the necessary details already filled in, pending only their confirmation to proceed with the transaction. This method simplifies the process for the user, making it more efficient and user-friendly.
The CoinMena widget URL allows the inclusion of a redirectUrl
parameter. Upon completion of a purchase, CoinMena will redirect the user to the specified URL using this parameter. This feature can be utilised by your application to detect the completion of a transaction and execute subsequent actions, such as providing the user with purchase status notifications.
if your app name is coinmena-example, and the parameter is set to redirectUrl = http://coinmena-example.com
the redirect would be as the following
Last updated