Revolut Pay Integration
B2B Wave integrates with Revolut Pay so your customers can pay for their orders through Revolut’s secure payment form when they check out. To use it, you need a Revolut Business account with an approved Revolut Merchant account.
Getting Your Revolut API Keys
B2B Wave connects to Revolut using two API keys: a Public key and a Secret key. To get them, follow these steps:
Step 1. Log in to Revolut Business.
Step 2. Navigate to Settings >APIs >Merchant API.
Step 3. Click “Generate” to create your API keys. Then copy both your Secret key and your Public key, as you’ll need them in the next section.

NOTE: Production keys only work for real payments. If you want to test the integration first, create a Revolut Sandbox account and use its API keys instead. See “Testing Revolut Pay Before Going Live” below.
Connecting Revolut Pay to B2B Wave
Step 1. Contact our support team to add the Revolut Pay payment option to your account.
Step 2. Go to Settings >Payment options on your Admin Dashboard and click the Revolut Pay payment option.
Step 3. In the “Revolut Pay Configuration” section, paste your Secret key in the “API Secret Key” field and your Public key in the “API Public Key” field. Then select the “Environment” your keys belong to.

Step 4. Fill in the remaining fields as needed, check “Active,” and click “Save.”
| Name | The name customers see for this payment option at checkout (e.g., Revolut Pay) |
| Description | A short description shown to customers on the checkout page |
| API Secret Key | The Secret key from your Revolut Merchant API settings |
| API Public Key | The Public key from your Revolut Merchant API settings |
| Environment | Select “Production” to accept real payments or “Sandbox” to test with your Revolut Sandbox keys. The keys must belong to the environment you select |
| Active | Check this box to offer Revolut Pay to your customers |
| Private | Check this box to offer Revolut Pay only to the customers you assign it to |
| View order | A number that sets where Revolut Pay appears in the list of payment options at checkout |
| Payment Fee Percentage | A percentage of the order total (products and shipping) added to orders paid with Revolut Pay, if applicable |
| Payment Fee Amount | A fixed fee added to orders paid with Revolut Pay, if applicable |
When you save, B2B Wave checks your Secret key with Revolut. If the check fails, you’ll see an error message and the payment option is deactivated until you correct the details and save again.
NOTE: Customers who have specific payment options assigned to them only see those options at checkout. Learn more about customer payment options here.
Testing Revolut Pay Before Going Live
Step 1. On the Revolut Pay payment option, enter your Revolut Sandbox API keys, select “Sandbox” as the “Environment,” and click “Save.”
Step 2. Log in to your store as a customer and place a test order, paying with one of Revolut’s test cards.
Step 3. Check that the order is placed and marked as paid on your Admin Dashboard.
Step 4. Replace the keys with your Production keys, select “Production” as the “Environment,” and click “Save.”
NOTE: While testing, check “Private” and assign Revolut Pay only to a test customer. That way, your real customers can’t place orders that are marked as paid with sandbox test payments.
How Customers Pay with Revolut Pay
When a customer selects Revolut Pay at checkout and places the order, they’re taken to the “Pay for order” page, where they complete the payment in Revolut’s payment form. The order is only placed after the customer completes the payment, so an order is never submitted without a payment attempt.

Customers have 30 minutes to complete the payment. After that, they need to place the order again from the checkout page.
Revolut Pay is also available when customers pay for an existing order later, for example when you’ve requested payment for it. In that case, they click “Pay” on the order and select Revolut Pay.
Payment Results
| Payment completed | The order is placed and marked as paid, with the paid amount and payment date filled in. The customer sees the order confirmation |
| Payment pending | The order is placed with the status “Awaiting Payment Confirmation,” and the customer is told the payment is pending confirmation. See “Confirming Pending Payments” below |
| Payment failed or cancelled | The order isn’t placed. The customer sees the message “Payment was not completed” and can try again or choose another payment option |
To find a payment in Revolut Business, open the order on your Admin Dashboard and look for the “Transaction id” in the payment details. In Revolut Business, each payment is also labeled with the B2B Wave order number (e.g., “Order #1234”).

Confirming Pending Payments
Sometimes Revolut is still processing a payment when the customer returns to your store. B2B Wave doesn’t update these orders automatically, so check them as follows:
Step 1. Go to the Orders menu on your Admin Dashboard and open the order with the status “Awaiting Payment Confirmation.”
Step 2. Use the “Transaction id” to find the payment in Revolut Business and check that it has been completed.
Step 3. Back on the order, check “Is paid?,” update the order status if needed, and save the order.
NOTE: If you don’t see the “Is paid?” checkbox on your orders, contact our support team.
Refunds
Refunds aren’t issued from B2B Wave. To refund a customer, find the payment in Revolut Business using the order’s “Transaction id” or order number, and issue the refund there.
Troubleshooting Error Messages
| “Revolut Pay API keys are missing (both Secret and Public keys are required)” | Enter both your Secret key and your Public key, then save again |
| “Revolut Pay environment mode is not selected” | Select “Production” or “Sandbox” in the “Environment” field, then save again |
| “Revolut Pay connection error: Invalid API key or connection failed” | Revolut didn’t accept your Secret key. Check that you copied it in full and that it belongs to the environment you selected (sandbox keys only work with “Sandbox”). If the problem continues, generate a new key in Revolut Business |
| “Error processing payment” or the payment form doesn’t load | Check that your Public key is correct and belongs to the same environment as your Secret key. B2B Wave only checks the Secret key when you save, so a wrong Public key shows up at checkout. Place a test order after any change to your keys |
NOTE: If you need help setting up Revolut Pay, contact our support team.