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