Vouchers - Issue
Issue: Approved vendors on Peerwallet can issue Peerwallet vouchers, which can be redeemed later. The minimum number of vouchers that can be created is 1, and the maximum is 5000.
Quantity: Within a single API call, you can specify the total quantity of vouchers to be created. The minimum quantity is 1, and the maximum per call is 100.
Expiry Date: Each voucher is valid for 1 year from the date of issuance.
Payment: Ensure you have sufficient balance, as the payment for vouchers will be deducted from your account balance.
Codes: The voucher codes will be sent to your email and will be displayed only once when you initiate the issue API. The codes cannot be fetched again via the API, as Peerwallet does not store them. All codes are hashed using a one-way hashing algorithm and cannot be retrieved by us. Please ensure you store the voucher codes correctly when you initiate the issue API. For future reference, you can refer to the email for the list of codes.
Order ID: Store the Order ID to fetch voucher codes within that group in the future.
Permission: This API call requires the "transfer funds" permission, which must be enabled in your API settings.
End Point
"https://calls.peerwallet.com
/voucher-issue"
Send your keys via headers
VALUE
api-private-key
REQUIRED
YES
DESCRIPTION
This is your Public API Keys which can be found here.https://peerwallet.
com/map/api-keys
Below are the POST values to send and their explanations on each field.
VALUE
quantity
REQUIRED
YES
DESCRIPTION
The total number of vouchers you want to buy. Minimum is 1 while maximum is 100 per call.
amount
YES
The amount stored in the voucher. Minimum is 1 while maximum is 5000
currency
YES
The default and only voucher currency for now is USD.
Return Values Success Sample
{
"status": 200,
"purchase_status":"success" ,
"order_id": "AQ09O09OLK" ,
"currency": "USD" ,
"quantity":5 ,
"amount": 2000 ,
"total_charged": 50,
"voucher_codes": "00000000000000000000,
00000000000000000000,
00000000000000000000,
00000000000000000000, 00000000000000000000" ,
"exp_date": 1749504154 ,
"date_created": 1717968154 ,
"receipt_url": "https://peerwallet.com/map/receipt?token=UIGIYOG97t6d9ygoihg87ghfeid
ygfudivyvgeuivyievguiy" ,
"note": "Voucher purchase was successful" ,
}
