What is the difference between 'GET by order Id' and 'GET by order reference'?
They both serve the same purpose i.e. to fetch the details of the voucher.However, GET by order id can be accessed using order id which is generated upon successful completion of create order and GET by CreateReference gives the flexibility to still check the status even for the scenarios where createOrder has timed out or had some network or system issues.
What is the idle polling interval for GET?
It is recommeded to use 2 seconds interval, however, advised to cap at 10-15 attempts.Please contact API Marketplace support team if the status remains pending after all attempts are exhausted.
What does 'NoVoucherCreated' error code means?
If 'NoVoucherCreated' error code is received, it means that there is no voucher created and no transaction has occurred.The orders need to be recreated as new.
How to contact API Marketplace support?
Send an email to Api Marketplace Tpp Support ApiMarketplaceTppSupport@Nedbank.co.za
What is the max amount for a voucher?
Max allowed amount per voucher is 5K, however there is no limit on number of vouchers.
What is the notification operation for?
This operation is only applicable for the TPPs that have opted for pin to be sent via sms from Nedbank side.This extends a re-sent functionality where sms is not received by the enduser when the voucher is created.
What does 'Account mismatch' error means?
It means the account information received in the request is not what is configured/agreed upon for the API.
Can a redeemed voucher be refunded?
Absolutely no.
How to identify the transaction on the statement?
The value that is passed as 'DebtorAccount.name' will reflect as transaction description on the statement.However, it is limited to 30 chars. It is recommended to use unique value for it to avoid any confusion.
What should be done if error code 429 'TooManyRequests' is received for GET's?
If the TPP is continuously polling GET by order id or order reference, and crosses the max cap permitted, 429 error will be sent back.
What happens if a voucher is redeemed at a retailer?
When a voucher is redeemed at a retailer, the status or details of the redemptions is only updated daily in batch. This means, if a client withdraws the voucher today, the status will update to redeemed but the details will only be updated the next day.