Opay via Flutterwave

Accept Opay payments from customers in Nigeria with Flutterwave as the payment service provider (PSP). The customer selects Opay, confirms the payment from their Opay wallet and returns to your site.

Supported workflows

Workflow	Supported
Payrails SDK	✔
Payrails API	✔
Delayed / Manual Capture	✖
Instant Capture	✔
Cancel / Void	✖
Refund / Reverse	✔
Save Instruments	✖
Merchant Initiated Transaction (MIT)	✖

Before you begin

Complete these steps before you send your first Opay payment through Flutterwave:

Set up a Flutterwave integration in your workspace. Follow the Flutterwave integration setup guide if you don’t have one yet.
In the Flutterwave dashboard, go to Settings → Business Preferences → Payment Methods and enable Opay.
In the Payrails Portal, go to Settings → Integrations, open your Flutterwave integration, select Opay under Payment methods, and save.
Add Opay as a payment option in your workflow.

Request fields for Flutterwave

Send these fields in the authorize request, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to the PSP when you include them.

Field	Status	Description
`amount.currency`	Required	Must be `NGN`. Payrails rejects other currencies.
`meta.customer.email`	Required	Sent to Flutterwave as the customer email.
`meta.customer.name`	Optional	Sent to Flutterwave as the customer name.
`meta.customer.phone`	Optional	Sent to Flutterwave as the customer phone number. Payrails joins the country code and the number.

Authorize an Opay payment

Call authorize a payment with oPayWallet as the paymentMethodCode. The response includes the redirect to the Opay payment page.

Authorize request

{
  "amount": {
    "value": "2500.00",
    "currency": "NGN"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "oPayWallet",
      "amount": {
        "value": "2500.00",
        "currency": "NGN"
      }
    }
  ],
  "meta": {
    "customer": {
      "email": "chiamaka.okafor@example.com",
      "name": "Chiamaka Okafor"
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

After the customer confirms the payment, Flutterwave returns them to your success or error URL. Confirm the result through webhook notifications or the execution status before you fulfill the order.

How Flutterwave handles Opay

Flutterwave processes Opay only in Nigeria. Payrails rejects Opay requests to Flutterwave in any currency other than NGN.
When the customer returns, Payrails fetches the transaction from Flutterwave to confirm the result.
To return funds after a successful payment, refund it.

Getting Started

Payment Orchestration

Token Vault

Analytics & Reporting

Fraud Management

Chargebacks

Monitoring

Resources

Use Cases

Supported workflows

Before you begin

Request fields for Flutterwave

Authorize an Opay payment

How Flutterwave handles Opay

​Supported workflows

​Before you begin

​Request fields for Flutterwave

​Authorize an Opay payment

​How Flutterwave handles Opay

Supported workflows

Before you begin

Request fields for Flutterwave

Authorize an Opay payment

How Flutterwave handles Opay