# Charge via Voucher payment
This page describes how to collect ZAR payments offline using Vouchers
<?php
$reference = Flutterwave::generateReference();
$data = [
'amount' => 100,
'email' => 'wole@email.co',
'tx_ref' => $reference,
'pin' => '19203804939000',
];
$response = Flutterwave::payments()->voucher($data);
if ($response['status'] === 'success') {
# code...
$data = Flutterwave::verifyTransaction($response['data']['id']);
return dd($data);
// Get the transaction from your DB using the transaction reference (txref)
// Check if you have previously given value for the transaction. If you have, redirect to your successpage else, continue
// Confirm that the $data['data']['status'] is 'successful'
// Confirm that the currency on your db transaction is equal to the returned currency
// Confirm that the db transaction amount is equal to the returned amount
// Update the db transaction record (including parameters that didn't exist before the transaction is completed. for audit purpose)
// Give value for the transaction
// Update the transaction to note that you have given value for the transaction
// You can also redirect to your success page from here
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# Parameters
Parameter | Required | Description |
---|---|---|
amount | True | This is the amount to be charged. Expected value is ZAR |
True | This is the email address of the customer. | |
tx_ref | True | This is a unique reference, unique to the particular transaction being carried out. It is generated when it is not provided by the merchant for every transaction. |
pin | True | This is the voucher pin given to the user after redemption at the agent location. They would provide this to you as the voucher code. |
fullname | False | This is the customers full name. It should include first and last name of the customer. |
phone_number | False | This is the phone number linked to the customer's mobile money account. |
client_ip | False | IP - Internet Protocol. This represents the current IP address of the customer carrying out the transaction |
device_fingerprint | False | This is the fingerprint for the device being used. It can be generated using a library on whatever platform is being used. |
meta | False | This is used to include additional payment information` |
subaccounts | False | This is an array of objects containing the subaccount IDs to split the payment into. Check our Split Payment page for more info |
meta | False | This is an object that helps you include additional payment information to your request e.g ['consumer_id'=>23, 'consumer_mac'=>'92a3-912ba-1192a'] |
redirect_url | False | This is a url you provide, we redirect to it after the customer completes payment and append the response to it as query parameters. |
country | False | Pass your country as US for US ACH payments and ZA for SA ACH payments. |