Off 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.

Parameter description:

ElementMandatoryData TypeRemarks
appIdYstringUnique identifier assigned by Alchemy Pay. You can find it in the merchant backend
timestampYstringThirteen-digit timestamp
typeYstringFixed value: sell
merchantOrderNoYstringMerchant order number, Alchemy Pay will carry this parameter in the webhook, allowing you to track order information using this parameter.
The merchantOrderNo cannot be duplicated.
signYstringFor the generation rules of the sign, please refer to this Click Here.URL encoding is required when concatenating to the request URL.
fiatNstringFiat currency user received, check the supported fiat currencies by Alchemy Pay Click Here.
Upload this field, users cannot modify the fiat currency.
If use this field, uploading country field is a must.
countryNstringRequired when uploading the fiat field.
Must correspond to the fiat field to be valid.
Follow the ISO 3166-1 alpha-2 standard.
cryptoAmountYstringThe quantity of the cryptocurrency that the user wishes to sell.
If passed, users will be unable to modify the cryptocurrency quantity.
When passing cryptoAmount, crypto must be passed simultaneously, otherwise it will be meaningless.
cryptoYstringThe cryptocurrency that the user wants to sell. You can check the cryptocurrencies supported by Alchemy Pay Click Here.
If passed, users will not be able to select other cryptocurrencies.
networkYstringThe cryptocurrency network that the user wants to sell. It is recommended to pass both the network and crypto parameters together to accurately limit the cryptocurrency the user can sell. You can check the supported networks Click Here.
If passed, users will not be able to modify the network.
The crypto and network parameters must match; otherwise, the passed parameters will not take effect.
emailNstringEmail used by the user. When you pass this parameter, we will pre-fill this email, but the user still needs to enter an email verification code to validate the email.
tokenNstringIf you have already verified the email of your user and wish to skip the email verification process during the Alchemy Pay experience, you can pass this parameter.
For the token generation rules, please refer to Click Here.
If the token parameter is uploaded, the email parameter does not need to be uploaded.
languageNstringLanguage 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 the ramp page to only display the off-ramp option, you can pass this parameter: showTable=sell
redirectUrlNstringThe webpage link where the user will be redirected after selling. You can customize this page.URL encoding is required when concatenating to the request URL.
callbackUrlNstringAfter the user sells, Alchemy Pay will notify you of the payment result at this address.URL encoding is required when concatenating to the request URL.
merchantNameNstringMerchant custom name, when merchants pass this name, the merchant name on the order completion page will be displayed according to this parameter.