Lookup a voucher using the voucher code.

This operation is used to verify the validity of a voucher and possibly establish the value of a previously issued voucher (if supported by the server). This operation has no financial impact and is informative only.

Request
Security:
query Parameters
voucherCode
string

The voucher code to be looked up.

provisionRequestId
string

The provision request id that was part of the original provision request to obtain a voucher.

receiverInstId
string

The institution which issued the voucher. This assists to direct the voucher lookup request if the destination cannot be determined from the voucher code alone.

settlementEntityInstId
string

The institution via which the lookup should be processed. This serves to better direct the lookup request in the case that multiple upstream parties are able to process the request.

voucherSerialNumber
string

The serial number of the voucher being looked up.

Responses
200

successful operation

202

Accepted

400

Bad Request

404

Not Found

500

Internal Server Error

503

Service Unavailable

504

Gateway Timeout

get/vouchers
Request samples
curl -i -X GET \
  -u <username>:<password> \
  'https://sandbox.electrum.io/suv/v1/vouchers?voucherCode=string&provisionRequestId=string&receiverInstId=string&settlementEntityInstId=string&voucherSerialNumber=string'
Response samples
application/json
{
  • "posInfo": {
    },
  • "settlementEntity": {
    },
  • "receiver": {
    },
  • "amounts": {
    },
  • "voucher": {
    },
  • "product": {
    },
  • "thirdPartyIdentifiers": [
    ],
  • "rrn": "string"
}
Copyright © Electrum Payments (Pty) Ltd. 2019-2022. All right reserved.