FAQs

SKU Questions

• Does RedeemSG also check SKU from API with whitelist we given, or it is only responsible by client side?

  • RedeemSG does not check if the SKUs provided are within the whitelist. This should be handled in the whitelisting module which you have implemented. However, the National Environmental Agency (NEA) conducts audits on the metadata to verify the eligibility of the SKUs. If discrepancies are found, NEA will follow up accordingly.

• Is there an error code returned if the API's SKU and whitelist do not match?

  • RedeemSG does not provide any error codes specifically for mismatched SKUs against the whitelist. It is the responsibility of your system to implement checks ensuring that only whitelisted SKU items can be used with the climate vouchers.

Idempotency Key Test Cases

• Our POS generates a unique Idempotency key when we test. We are not able to test certain test cases

  • That is the correct implementation. For UAT, you might encounter difficulty in testing scenarios where no Idempotency Key is used or where the same Idempotency Key is applied (e.g. test case 2-5). To address this, we suggest configuring your backend (i.e. hardcode) to simulate these scenarios.

  • By setting up your backend to handle scenarios both with and without unique Idempotency Keys, you can thoroughly test your system under various conditions, ensuring that it performs reliably in real-world scenarios.

Scanning of Vouchers

• My system has difficulty scanning a 15 generated voucher as it is too dense.

  • During User Acceptance Testing (UAT), it's essential that the POS system can successfully scan up to 15 vouchers being generated.

Handling different Voucher Amount and Balances

• Residents provided a $10 voucher but the item costs $8. What should I do?

  • In this scenario, the resident will forfeit the remaining $2. Though the utilised voucher value is $8, NEA will however pay you $10. It is thus crucial to transparently display the scanned voucher value, and forfeited voucher value on your POS, invoice and receipt.

• Should I subtract the voucher amount before or after GST?

  • Vouchers are treated as a form of payment. They should be applied to the outstanding balance for whitelisted items after tax is charged. Therefore, the voucher amount should be subtracted from the price of eligible items, inclusive of GST.