Introduction

4.2.1 Introduction

For example, if the request to redeem a voucher does not respond due to a connection issue, you can retry the request with the same idempotency key sent in the first request to guarantee that no more than one voucher redemption operation is attempted.

This is important as vouchers cannot be logically redeemed twice. Subsequent attempts without idempotency key header to redeem the same voucher will always result in a HTTP 402 response with error code, redemption_vouchers_used, as the voucher has already been redeemed in the prior request.

If subsequent retries are not identified with an idempotency key, disputes on whether the vouchers were successfully redeemed or was already used could occur.

It is compulsory for retailers to include idempotency key whenever making a redemption call to RedeemSG API