Error codes

6.2 Error codes

Below is a non-exhaustive list of errors pertinent to merchant integration.

You should show the error.message below as-is on your POS. Do not tweak the error message to be shown.

error.code
HTTP Code
error.message
error.type

authentication_required

401

Please log in or provide an API key

invalid_request_error

api_key_invalid

401

Invalid API Key provided

invalid_request_error

redemption_vouchers_used

402

Voucher/s selected for redemption has already been used

invalid_request_error

redemption_vouchers_voided

402

Voucher/s selected for redemption has been voided

invalid_request_error

redemption_vouchers_period_not_started

402

Redemption period for voucher/s selected has not started yet

invalid_request_error

redemption_vouchers_period_ended

402

Redemption period for voucher/s selected has ended

invalid_request_error

redemption_vouchers_merchant_forbidden

403

Voucher/s selected for redemption cannot be used at your shop

invalid_request_error

redemption_vouchers_not_found

404

Voucher/s selected for redemption could not be found

invalid_request_error

redemption_vouchers_not_same_campaign

400

Vouchers selected for redemption must be from same campaign

invalid_request_error

redemption_vouchers_not_same_type

400

Voucher/s selected for redemption must be of same type

invalid_request_error

redemption_vouchers_not_same_group

400

Voucher/s selected for redemption must be of same group

invalid_request_error

idempotent_request_in_progress

409

Request with existing idempotency key is currently still executing

idempotency_error

Last updated