Initiate a transaction

Once you're all set, you're ready to let your customers buy crypto with us.

Redirect the customer

The first step is to redirect your customer to our platform using a special URL:

https://ramp.revolut.com/?<YOUR_PARAMETERS_LIST>

This URL consists of the Revolut Ramp platform address followed by a list of different key-value parameters, which you can set before you redirect the customer to us. The parameters list follows ?, and multiple parameters are separated by &, like this:

<PARAMETER1>=<VALUE_FOR_PARAMETER1>&<PARAMETER2>=<VALUE_FOR_PARAMETER2>

What is more, you can decide whether to let the customer modify these parameters after redirection or not.

An example URL looks like this:

https://ramp.revolut.com/?fiatAmount=700&walletAddress=0xc1912fee45d61c87cc5ea59dae31190fffff232d&partnerId=fb48770a-51b0-402e-8d25-33474f474aa2

Configurable parameters

These are the parameters that you can configure and include in the Revolut Ramp Redirect URL:

Parameter	Description	Example	JSON type
`fiatAmount`	Default fiat amount	`fiatAmount=10`, `fiatAmount=12.50`	number($float)
`fiatCurrency`	ISO 4217 code of the default fiat currency. Defaults to `GBP`.	`fiatCurrency=EUR`	string
`cryptoCurrency`	Default crypto currency symbol. Defaults to `ETH`.	`cryptoCurrency=BTC`	string
`countryCode`	ISO 3166 Alpha-2 code of the country	`countryCode=GB`	string
`walletAddress`	Default wallet address	`walletAddress=` `0xc1912fee45d61c87cc5ea59dae31190fffff232d`	string
`partnerId`	Partner ID. It allows us to distinguish transactions from a particular Partner. It is useful, for example, for customer support or financial settlements with Partners.	`partnerId=fb48770a-51b0-402e-8d25-33474f474aa1`	string
`externalOrderId`	External order ID. May be provided by the Partner on order creation via the `ramp_redirect_url` that redirects the customer to Revolut Ramp. It allows the Partner to fetch an order from the Revolut Ramp database based on this ID using the `/order` endpoint. Must match following regular expression: `^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})\\|(?:[0-9a-zA-Z]{26})$`	`externalOrderId=a01868cc-71ab-d2ed-a10b-0a32ac1c0b02`	string($regexp)
`partnerRedirectUrl`	Success Redirect URL. If provided, the customer is redirected to this URL upon successful order creation. Otherwise, the customer is taken to the transaction details on Revolut Ramp.	`partnerRedirectUrl=https://example.com`	string($uri)

Input Control Parameters

On top of the parameters above, you can also decide to disable input for certain parameters. This is useful when you want to pre-configure these parameters and don't want the customer to modify them. These are the disable options that you can use:

Parameter	Description	Example usage	JSON type
`disableFiatAmount`	Disable the Fiat amount input. If `fiatAmount` is not provided, this is overridden with `false`. Defaults to `false`.	`disableFiatAmount=true`	boolean
`disableCountryCode`	Disable the Country code selection input. If `countryCode` is not provided, this is overridden with `false`. Defaults to `false`.	`disableCountryCode=true`	boolean
`disableWalletAddress`	Disable the Wallet address input. If `walletAddress` is not provided, this is overridden with `false`. Defaults to `false`.	`disableWalletAddress=true`	boolean

Page Control Parameters

You can also choose to skip showing certain selection/input pages to the customer when making the purchase:

Parameter	Description	Example usage	JSON type
`skipWalletAddress`	Skip the Wallet address page. If `walletAddress` is not provided, this is overridden with `false`. Defaults to `false`.	`skipWalletAddress=true`	boolean

What's next

Once you redirect the user to Revolut Ramp, they go through order creation on our portal. For more details, see the order creation from customer's perspective.