RyftPay Integration

6 min. readlast update: 05.23.2025

Guide to Configuring Store Integrations with RyftPay

This step-by-step guide will help you set up RyftPay, a payment gateway that allows Marketplace Owners to process payments securely on behalf of their merchants. This integration is designed specifically for Marketplace and Multi-Store Owners.


Step 1: Set Up the Payment Method Integration

Before your Marketplace or Multi-Store can process payments with RyftPay, you must have a RIftpay Account. The link to create an account will be sent by the Onboarding Team.

If you want your Merchants to get the payments through Riftpay, all Sub-Accounts with your Merchannts must be created on Riftpay Dashboard and be connected through the Payment Method Integration settings.

How to Configure:

  1. Navigate to Company View

    • Go to your Order Tiger Dashboard

    • Switch to Company View

    • Go to Finances > Payment Method Integration

  2. Choose the Merchant

    • From the dropdown menu, select the Company or Location you want to integrate.

     3. Open the RyftPay Integration Panel

    • Click the “+” icon to expand the RyftPay integration box.

   4. Fill in the Required Fields

Here's how to complete the setup form:

    • Identifier Name: Set your Company Name
    • Public and Secret Keys: Use Ryft for both fields.

    • Environment: Set to LIVE. In case you want to do a TEST, choose SANDBOX

    • Auto Settle Payments: Set to FALSE – this ensures funds are only captured once the merchant accepts the order.

    • Currency: Set GPB, EURO or USD depending on the currency your Company is operating with.
    • Enable Apple Pay / Google Pay: Make sure both options are enabled so that customers can pay with both methods.

    • iOS Merchant ID: Leave blank. Our Developers will fill in this box.

    • Percentage Card Fee / Fixed Card Fee: Optional - Only if you're charging your merchants a card fee.

      - For OUTSOURCED DELIVERY: subtract the Delivery Fee, Driver Tip, Service Fee to the Platform, and Tip to the Merchant;



      - For SELF DELIVERY: subtract the Service Fee to the Platform, Delivery Fee, Driver Tip, and Tip to the Merchant:



      - For COLLECTION: subtract the Service Fee to the Platform and tip to the Merchant:



    • Percentage Commission Fee: Add your commission (VAT included) that you will charge to your Merchant (Riftpay Sub-Accounts)

    • Fixed Application Fee: Leave blank

    •  

✅ Tip: If the same Percentage Commission Fee applies to all order types, only one Payment Method Integration is needed.

  1. Commission Fee Rule

    • Apply the fee only to the Subtotal (not including delivery, tips, etc.)

                 



Step 2: Add RyftPay Webhook

To enable transaction updates, set up the webhook in your Ryft dashboard:

  1. Visit your Ryft dashboard

  2. Click “Add Webhook”

  3. Use this Webhook URL:
    https://prod-api.ordertiger.com/api/v1/ryftpay/webhook

  4. Set Status to: ACTIVE

  5. Select the following Events:

    • PaymentSession.approved

    • PaymentSession.captured

  6. Click Save


Step 3: Activate the Merchant’s RyftPay Sub-Account

Once the Payment Method Integration is configured, each merchant must activate their RyftPay sub-account.

How to Proceed:

  1. Send Activation Instructions
    Email the restaurant with a link to activate their account:
    (Replace yourdomain.com with your actual domain)

  2. Merchant Instructions

    • Enter their email address

    • Choose RyftPay from the list of Payment Processors

    • Complete the RyftPay onboarding form

Required Verification

  • Sole Traders

    • No immediate documents required unless sales exceed £2,000

    • At that point, RyftPay will request proof of ID and address

  • Limited Companies

    • Proof of Business: Certificate of Incorporation

    • Proof of Identity: Passport or Driving License

    • Proof of Address (Director only): Recent utility bill or bank statement (under 3 months old)

📧 For support, merchants can contact underwriting@ryftpay.com
📄 A detailed onboarding guide is also available: Account Verification Document


Step 4: Locate the Sub-Account ID

Once a merchant has completed onboarding:

  1. Go to the Ryft dashboard

  2. Find the merchant’s account by name or email

  3. Copy the Sub-account ID located at the top left

⚠️ If verification is pending, the status may show “Under Review” or “Not Required.” A verified status means they are ready to go live.


Step 5: Enable RyftPay for Payments

Once the Sub-account ID is available, return to the Order Tiger Dashboard:

  1. Switch to Location View

  2. Go to Payment Methods

  3. Select the store branch

  4. Edit the CARD payment method

  5. Choose RyftPay from the Payment Processor list

  6. Paste the merchant’s Sub-account ID

  7. Save your changes

Repeat these steps for Delivery, Collection, or Eat-in, if applicable.

✅ Once completed, merchants can start processing payments with RyftPay through Order Tiger.


How to do a refund from Dashboard?

Riftpay refunds can be issued directly through the Order Tiger Dashboard.

Please follow the steps below to complete the refund:

Log in to the Dashboard and navigate to the "Orders" section.

 
  • Enter the Order ID you want to refund (3963601) into the "Order ID" search tab and click Search.

 
  • Once the order appears, click the card icon on the right-hand side of the accepted order.

  • In the new window, enter the refund amount and provide a reason for the refund.

  • Click Save to process the refund. The customer will be refunded, and a confirmation email will be sent to them automatically.

Was this article helpful?