1Voucher is a South African alternative payment method . They provide a payment option for merchants operating in South Africa, allowing customers to pay for goods and services though redeeming prepaid vouchers.

You can use 1Voucher as a Payment Method for:

	REST API	WebSDK	Hosted Payment Page
Payments	✅ Available	⛔️ Unavailable	⛔️ Unavailable
Split Auth & Capture	⛔️ Unavailable	⛔️ Unavailable	⛔️ Unavailable
Payouts	⛔️ Unavailable	⛔️ Unavailable	⛔️ Unavailable
Refunds	⛔️ Unavailable	⛔️ Unavailable	⛔️ Unavailable

Payments

The BR-DGE 1Voucher Payment Instrument can be used to redeem 1Vouchers. BR-DGE takes the 1Voucher PIN and sends it to Flash, the official distributor and processing provider for 1Voucher, to redeem.

📘
1Voucher payments are only supported with South African Rand (ZAR). No other currencies are supported.

Partial Voucher Redemptions

BR-DGE only supports full voucher redemption for 1Voucher. Partial redemptions are not supported.

The outcome of a voucher redemption is either CAPTURED or REJECTED.

BR-DGE Status	Description
`CAPTURED`	The voucher is successfully redeemed
`REJECTED`	The voucher could not be redeemed. It may have already been redeemed, has expired, or is inactive.

Payment API Examples

To create a 1Voucher payment, you must send a request similar to the following to the POST /v1/payments REST API Endpoint.

{
  "merchantTransactionId": "ff163246-eb94-4763-9a2a-f5d6d48b026e",
  "amount": 0,
  "customerOrderCode": "ABC456",
  "orderDescription": "Taxi fare",
  "channel": "ios",
  "currencyCode": "ZAR",
  "customerPhoneNumber": "+44 1231110000",
  "customerEmail": "[email protected]",
  "paymentInstrument": {
    "type": "oneVoucher",
    "pin": "1234567812345678"
  }
}

You should expect to receive a response similar to the one below, indicating whether the voucher redemption was successful or not.

📘
For security purposes, the sensitive PIN is not returned in the payment response.

{
  "code": "1000",
  "message": "Approved",
  "comcardeCode": {
    "code": "1000",
    "description": "Approved"
  },
  "id": "691ca00b78759f29aa82ec4597b2d512",
  "paymentId": "c2fcf424-d7df-4b8b-aa98-3a60ce990d7c",
  "status": "CAPTURED",
  "timestamp": "2022-01-30T10:10:10Z",
  "reference": "example-customer-order-code",
  "amount": 2000,
  "currencyCode": "ZAR",
  "paymentInstrument": {
    "type": "oneVoucher"
  },
  "psp": {
    "name": "Flash",
    "transactionId": "a83a53a2-dcc8-45be-bf70-2b1e4b719f7c"
  }
}

📘
The API requires the voucher's PIN, which must be a numeric string of 16 digits.

Verification

The voucher amount cannot be verified independently of making a payment. The amount on the payment request must be set to '0' for full redemption in all cases and the vouchers value is returned in the payment response.

📘
The voucher amount returned is in the minor unit. For example, if 1250 is returned on the response as the amount, then this translates to R12.50.

Onboarding & Support

To enable 1Voucher on your BR-DGE retail channels, please get in contact with support.