On Ramp Custom Parameters

Introduction:

  • By using page mode, you can pass parameters to replace user input and simplify the user flow.
  • If you cannot confirm the user's email, please do not use the email parameter. If you have not verified the user's email, please do not use the token parameter.
  • The link will take effect only after the mandatory parameters are sent.

Example link:

https://ramptest.alchemypay.org?appId=f83Is2y7L425rxl8&crypto=USDT&network=ETH&showTable=buy&fiat=USD&fiatAmount=30×tamp=1538054050234&sign=JY9JcOwBosncT19Nn9DIfTH%2BvfSt6xL%2BI%2BRVCl9YGgE%3D](https://ramptest.alchemypay.org?appId=f83Is2y7L425rxl8&crypto=USDT&network=ETH&showTable=buy&fiat=USD&fiatAmount=30&timestamp=1538054050234&sign=JY9JcOwBosncT19Nn9DIfTH%2BvfSt6xL%2BI%2BRVCl9YGgE%3D

Parameter description:

ElementMandatoryData TypeRemarks
appIdYstringUnique identifier assigned by Alchemy Pay. You can find it in the merchant backend
timestampYstringThirteen-digit timestamp
merchantOrderNoYstringMerchant Order Number, unique order number provided by merchant.This parameter will carry in the webhook, allowing you to track order information through this parameter.
The merchantOrderNo cannot be duplicated.
signYstringRefer to this link for the sign generation rules Click Here.URL encoding is required when concatenating to the request URL.
fiatNstringThe fiat currency to be paid by the user (must be in uppercase),You can check the list of fiat currencies supported by Alchemy PayClick Here
If passed, the user will not be able to change the fiat currency
fiatAmountNstringThe fiat currency amount that the user needs to pay
If passed, the user will not be able to modify the order amount.
When passing fiatAmount, it is necessary to simultaneously include the fiat parameter; otherwise, it will be meaningless.
cryptoNstringThe cryptocurrency that the user wants to purchase. You can check the supported cryptocurrencies by Alchemy Pay Click Here.
If passed, the user will not be able to change the cryptocurrencies.
'crypto' and 'network' must match; if they don't match, the parameter will not take effect.
networkNstringThe cryptocurrency network that the user is allowed to use. It is recommended to pass 'network' and 'crypto' together to accurately limit the cryptocurrency the user can purchase. You can check the supported networks by Alchemy Pay Click Here.
If passed, the user will not be able to change the network.
'crypto' and 'network' must match; if they don't match, the parameter will not take effect.
addressNstringThe wallet address where the user wants to receive the cryptocurrency. If passed, the user will not be able to change the wallet address.
The 'address' must match the 'network'; otherwise, the passed parameter will not take effect.
Additionally, when passing 'address', make sure it is an address owned by the user.
memoNstringNote: some networks require the memo field to be uploaded. Please refer Click Here
emailNstringThe user's email. If you pass this parameter, we will automatically pre-fill the email. However, the user still needs to enter an email verification code to verify the email.
tokenNstringIf you have already verified the user's email and want to skip the email verification process in AlchemyPay's experience, you can pass this parameter. Refer to this link for the token generation rules.Click Here
If the token parameter is uploaded, the email parameter does not need to be uploaded.
languageNstringThe language of the ramp page opened by the user.
Spanish: es
Traditional Chinese:zh-HK
English:en-US
Vietnamese:vi
Indonesian:id
eg:language=en-US
showTableNstringIf you want to display only the on-ramp options on the ramp page, you can pass this parameter. Use 'showTable=buy'.
redirectUrlNstringThe URL of the web page where the user will be redirected after a successful/failed purchase.URL encoding is required when concatenating to the request URL.
callbackUrlNstringAfter a successful/failed purchase, Alchemy Pay will notify you of the payment result at this address. Refer to this link for the specific notification content.Click Here.URL encoding is required when concatenating to the request URL.
merchantNameNstringWhen merchants pass this custom name, the merchant name displayed on the order completion page will be shown according to this parameter.
displayAddressNstringFixed: true
If the address parameter is uploaded along with this parameter, it will redirect to the "Confirm wallet address page".

🚧

Implementing Google Pay on Android

Currently Google Pay cannot be used as a webview within Android apps. This is because pop-up blockers are built into the webviews, preventing Google Pay to be displayed. As a result, in order to allow your customers to purchase crypto using Google Pay, you will need to redirect the customer to the browser.