On Ramp自定义参数

您在网页对接中,可以传入以下参数以减少用户的输入,这将简化用户的操作流程,提升转化率。

需要注意的是,以下参数只有appId是必须的,其他所有参数均为可选的。

示例链接:

https://ramptest.alchemypay.org/?crypto=USDT&network=BSC&appId=f83Is2y7L425rxl8&sign=TUqyu6jxuhLsO7qtJmGplbI3CSGHNyvrETmlWDagGytpQio3VWFgGUcOxW2Ts6TQX3lyDQTwj%2F96uqSPXxQtieX2bZ2ddWacM3tIA%2Fo58Mc%3D&address=0xeaf936e4bd0cf40958e74fce896e976459a83b90

appId

📘

appId是必须的,您必须传入appId才能使以下参数生效

merchantOrderNo

您为此订单生成的商户订单号,Alchemy Pay将会在webhook中携带此参数,由此您可以通过此参数追踪订单信息。

fiat

这代表用户需要支付的法币币种。如果传入,用户将无法修改法币币种。Alchemy Pay支持的法币币种可以在此查看

示例:fiat=USD

fiatAmount

这代表用户需要支付的法币金额。如果传入,用户将无法修改订单金额。

当您传入fiatAmount时,需要同时传入fiat,否则将没有意义。

示例:fiatAmount=100

crypto

这代表用户要购买的数字货币币种。如果传入,用户将无法购买其他数字货币。Alchemy Pay支持的数字货币币种可以在此查看

示例:crypto=USDT

network

这代表用户允许使用的数字货币网络。建议将network和crypto一起传入,这样可以准确限制用户购买的数字货币。如果传入,用户将无法修改网络。网络可以在此查看

crypto和network参数匹配,如果您传入的crypto和network不匹配,您传入的参数将不会生效。

示例:network=ETH

address

这代表用户要接收数字货币的钱包地址。如果传入,用户将无法修改钱包地址。

address需要与network匹配,如果您传入的address与network不匹配,您传入的所有参数将不会生效。

当您传入address时,需要保证address为用户拥有的地址。

示例:address=0xf220caa5053fc9f81a968489e46b086ae907b6c9

memo

注意:BNB、EOS、SEI、XLM、XRP网络memo参数必传。

🚧

当您传入address参数时,您必须添加sign,否则将不会生效

sign

当address传入时,此参数必须。其他情况下,不需要传入。

需要签名的参数为address和appId,拼接示例:

address=0xeaf936e4bd0cf40958e74fce896e976459a83b90&appId=f83Is2y7L425rxl8

关于sign的生成规则,参照此处

email

这代表用户使用的邮箱,当您传入此参数时,我们将会将此邮箱默认带入,但用户仍然需要输入邮箱验证码来验证次邮箱。

示例:email=[email protected]

token

如果您已验证过您的用户的邮箱,并且希望用户在AlchemyPay的体验中免去邮箱验证环节,您可以传入此参数。

关于token的生成规则,参照此处

🚧

如果您无法确认用户的邮箱,请不要使用此参数。如果您已经生成token,则在链接中只需要传入token,不需要再传入email。

language

这代表用户打开的ramp页面的语言。

es 西班牙语
zh-HK 繁中
en-US 英语

示例:language=en-US

showTable

如果您希望打开的ramp的页面只展示on ramp选项,您可以传入此参数。

示例:showTable=buy

redirectUrl

这代表用户用户购买成功/失败后跳转的网页页面链接,您可以自定义此页面。

callbackUrl

用户购买成功/失败后,Alchemy Pay将向此地址通知您支付结果。通知的具体内容您可以参照此处

merchantName

商户自定义名称,当商户传入此名称时,订单完成页面的商户名称将按照此参数展示。

🚧

在Android设备中使用Google Pay

目前 Google Pay 无法在 Android 应用程序的网页视图使用。这是因为弹出窗口拦截器内置于网络视图中,阻止显示 Google Pay。因此,为了允许您的客户使用 Google Pay 购买加密货币,您需要将客户引导到浏览器中购买加密货币。

更多信息请参考: https://developers.google.com/pay/api/web/support/faq