{"title":"Revolut Pay for API only","category":"default","creationDate":1778167252,"content":"

You can add Revolut Pay to your existing integration. The following instructions show only what you must add to your integration specifically for Revolut Pay.<\/p>\n

If an instruction on this page corresponds with a step in the main integration guide, it includes a link to corresponding step of the main integration guide.<\/p>\n

Requirements<\/h2>\n\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nMake sure that you have an existing API-only integration<\/a>.<\/td>\n <\/td>\n<\/tr>\n
Redirect handling<\/strong><\/td>\nMake sure that your existing integration is set up to handle the redirect<\/a>.
action.type<\/code>: redirect<\/strong>.<\/td>\n		<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

How it works<\/h2>\n
    \n
  1. The shopper selects Revolut Pay as the payment method.<\/li>\n
  2. The shopper enters their details in the payment form that you build<\/a>.<\/li>\n
  3. The shopper is redirected to the Revolut Pay app (mobile devices) or a Revolut Pay hosted payment page (desktops or laptops) where four different sign-in methods are offered: QR code, email, SMS, and passkey.<\/li>\n
  4. The shopper authorizes the payment in the Revolut Pay app.<\/li>\n<\/ol>\n

    Build your payment form<\/h2>\n

    Include Revolut Pay in the list of available payment methods<\/a>. You do not need to collect any information from the shopper in your payment form.<\/p>\n

    \n

    You can download the logo for Revolut Pay<\/a> to use in your form.<\/p>\n<\/div>\n

    Get Revolut Pay as an available payment method<\/h2>\n

    When you make the \/paymentMethods<\/a> to get available payment methods<\/a>, specify the following so that Revolut Pay is included in the response.<\/p>\n\n\n\n\n\n
    Parameter<\/th>\nValues<\/th>\n<\/tr>\n<\/thead>\n
    amount.currency<\/a><\/td>\nEUR<\/strong>, GBP<\/strong>, PLN<\/strong>, RON<\/strong>, HUF<\/strong>, CHF<\/strong>, CZK<\/strong>, NOK<\/strong>, DKK<\/strong>, SEK<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n <\/code-sample>\n<\/div>\n
    \n <\/code-sample>\n<\/div>\n

    Add additional parameters to your \/payments request<\/h2>\n

    When you make a payment<\/a>, add the following parameters:<\/p>\n\n\n\n\n\n\n\n\n\n
    Parameter<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
    paymentMethod.type<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nrevolutpay<\/strong><\/td>\n<\/tr>\n
    shopperName<\/code><\/td>\n<\/td>\nThe name of the person funding the money.<\/td>\n<\/tr>\n
    telephoneNumber<\/code><\/td>\n<\/td>\nThe shopper's telephone number.<\/td>\n<\/tr>\n
    shopperEmail<\/code><\/td>\n<\/td>\nThe email address of the person funding the money.<\/td>\n<\/tr>\n
    shopperStatement<\/code><\/td>\n<\/td>\nThe text to be shown on the shopper's bank statement. Allowed characters: a-z, A-Z, 0-9, spaces, and special characters . , ' _ - ? + * \/. The complete descriptor is built using the following format: {base}{suffix}<\/code>, where:{base}<\/code> is your Merchant name as specified in your Merchant settings at the time you added Revolut Pay to your merchant account. This name can't be changed afterward.{suffix}<\/code> is defined by the value specified for the shopperStatement<\/code> parameter. You can use <= 19 characters. We recommend sending a maximum of 22 characters for the complete descriptor, otherwise banks might truncate the string.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n <\/code-sample>\n<\/div>\n

    The response includes the action.type<\/code>: redirect<\/strong>.<\/p>\n

    \n <\/code-sample>\n<\/div>\n

    Handle the redirect<\/h2>\n
      \n
    1. \n

      To complete the payment, redirect the shopper to the action.url<\/code> returned in the \/payments<\/a> response, taking into account the following recommendations:<\/p>\n