On Ramp自定义参数
使用网页对接,可以传入以下参数以减少用户的輸入操作,简化流程,提升转化率。
*需要注意的是,以下参数只有appId是必须的,其他所有参数均为可选的。
示例链接:
参数名 | 必选 | 说明 |
---|---|---|
appId | Y | 必须传入appId才能使以下参数生效 |
merchantOrderNo | N | 您为此订单生成的商户订单号,Alchemy Pay将会在webhook中携带此参数,由此您可以通过此参数追踪订单信息 |
fiat | N | 代表用户需要支付的法币币种。如果传入,用户将无法修改法币币种。Alchemy Pay支持的法币币种可以在此查看示例:fiat=USD |
fiatAmount | N | 这代表用户需要支付的法币金额。如果传入,用户将无法修改订单金额。 当您传入fiatAmount时,需要同时传入fiat,否则将没有意义。 示例:fiatAmount=100 |
crypto | N | 这代表用户要购买的数字货币币种。如果传入,用户将无法购买其他数字货币。Alchemy Pay支持的数字货币币种可以在此查看。 示例:crypto=USDT |
network | N | 这代表用户允许使用的数字货币网络。建议将network和crypto一起传入,这样可以准确限制用户购买的数字货币。如果传入,用户将无法修改网络。网络可以在此查看。 crypto和network参数匹配,如果您传入的crypto和network不匹配,您传入的参数将不会生效。 示例:network=ETH |
address | N | 这代表用户要接收数字货币的钱包地址。如果传入,用户将无法修改钱包地址。 address需要与network匹配,如果您传入的address与network不匹配,您传入的所有参数将不会生效。 当您传入address时,需要保证address为用户拥有的地址。 示例:address=0xf220caa5053fc9f81a968489e46b086ae907b6c9 |
memo | N | BNB、EOS、SEI、XLM、XRP网络memo参数必传。 |
sign | N | 当address传入时,此参数必须传入。其他情况下不需要。 需要签名的参数为address和appId,拼接示例: address=0xeaf936e4bd0cf40958e74fce896e976459a83b90&appId=f83Is2y7L425rxl8 关于sign的生成规则,参照此处。 |
N | 这代表用户使用的邮箱,当您传入此参数时,我们将会将此邮箱默认带入,但用户仍然需要输入邮箱验证码来验证次邮箱。 示例:email=[email protected] | |
token | N | 如果您已验证过您的用户的邮箱,并且希望用户在AlchemyPay的体验中免去邮箱验证环节,您可以传入此参数。 关于token的生成规则,参照此处。 如果您无法确认用户的邮箱,请不要使用此参数。如果您已经生成token,则在链接中只需要传入token,不需要再传入email。 |
language | N | 这代表用户打开的ramp页面的语言。 es 西班牙语 zh-HK 繁中 en-US 英语 示例:language=en-US |
showTable | N | 如果您希望打开的ramp的页面只展示on ramp选项,您可以传入此参数。 示例:showTable=buy |
redirectUrl | N | 这代表用户用户购买成功/失败后跳转的网页页面链接,您可以自定义此页面。 |
callbackUrl | N | 用户购买成功/失败后,Alchemy Pay将向此地址通知您支付结果。通知的具体内容您可以参照此处。 |
merchantName | N | 商户自定义名称,当商户传入此名称时,订单完成页面的商户名称将按照此参数展示。 |
在Android设备中使用Google Pay
目前 Google Pay 无法在 Android 应用程序的网页视图使用。这是因为弹出窗口拦截器内置于网络视图中,阻止显示 Google Pay。因此,为了允许您的客户使用 Google Pay 购买加密货币,您需要将客户引导到浏览器中购买加密货币。
更多信息请参考: https://developers.google.com/pay/api/web/support/faq
Updated 8 months ago