Ramp Partners API
Retrieve a redirect URL
api
get
/buy

Retrieve a redirect URL

Retrieve a redirect URL to the Ramp UI widget for provided buy parameters. Use it to redirect the customer to Revolut Ramp to make the purchase.

X-API-KEY​

Each Revolut Ramp Partners API call must contain an authorization header in the following format to make a call: X_API_KEY: {your_API_key}.

Before you start, make sure that you've got the correct API key. For more information, see Get Partner keys.

Request​

Query Parameters
Query Parameters

ISO 4217 code of the selected fiat currency

Fiat amount to exchange for crypto

Crypto token to purchase, id obtained from /config endpoint

Possible values: [card, revolut, apple-pay, google-pay]

Selected payment option

Country of residence of the customer ordering the exchange

Wallet address to which to transfer crypto

External identifier of the order, should be either UUID or ULID

Fee percentage that will be applied for the order as partner fee

The URL to which to redirect the customer after the purchase

A prefix enabling to pass arbitrary key-value pair. Prefix and key should be separated by '.' so resulting param(s) should follow pattern additionalProperties.[key]=[value]. Later when using /orders endpoint additional properties will be returned along with an order

Response​

OK

Response body
Body object 

The URL to Revolut Ramp to which to redirect the customer for the purchase

Was this page helpful?
Loading...