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

Before you begin

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

Set up a Flutterwave integration in your workspace. Contact your Payrails account team if Flutterwave isn’t listed in your Payrails Portal 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. Payrails checks Required fields and returns an error when one is missing. Fields required by the PSP pass the Payrails checks but the PSP can decline the payment without 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.
Cancel isn’t available for Opay payments through Flutterwave. 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