1Voucher via Flutterwave

Accept 1Voucher payments from customers in South Africa with Flutterwave as the payment service provider (PSP). The customer selects 1Voucher, redeems their voucher PIN on the Flutterwave payment page and returns to your site.

Supported workflows

Before you begin

Complete these steps before you send your first 1Voucher 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 1Voucher.
In the Payrails Portal, go to Settings → Integrations, open your Flutterwave integration, select 1Voucher under Payment methods, and save.
Add 1Voucher 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 `ZAR`. Payrails rejects 1Voucher requests to Flutterwave in any other currency.
`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 a 1Voucher payment

Call authorize a payment with 1voucher as the paymentMethodCode. The response includes the redirect to the Flutterwave payment page.

Authorize request

{
  "amount": {
    "value": "250.00",
    "currency": "ZAR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "1voucher",
      "amount": {
        "value": "250.00",
        "currency": "ZAR"
      }
    }
  ],
  "meta": {
    "customer": {
      "email": "thandiwe.nkosi@example.com",
      "name": "Thandiwe Nkosi",
      "phone": {
        "countryCode": "+27",
        "number": "821234567"
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

After the customer redeems the voucher, 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 1Voucher

Payrails sends the payment to the Flutterwave hosted payment page with 1Voucher as the only payment option.
When the customer returns, Payrails fetches the transaction from Flutterwave to confirm the result. Flutterwave also notifies Payrails of the final result.
To return funds after a successful payment, refund it. Flutterwave supports full and partial refunds.

Getting Started

Payment Orchestration

Token Vault

Analytics & Reporting

Fraud Management

Chargebacks

Monitoring

Resources

Use Cases

1Voucher via Flutterwave

Supported workflows

Before you begin

Request fields for Flutterwave

Authorize a 1Voucher payment

How Flutterwave handles 1Voucher

​Supported workflows

​Before you begin

​Request fields for Flutterwave

​Authorize a 1Voucher payment

​How Flutterwave handles 1Voucher

Supported workflows

Before you begin

Request fields for Flutterwave

Authorize a 1Voucher payment

How Flutterwave handles 1Voucher