Payment errors

When a card or other payment is declined, the Campaigns API answers the order with a payment_response_code. Each of the 37 codes has a sentence for the shopper in every language, at payment.errors.<code> in GET /v1/locales/:lang.

Showing a decline

Show payment.errors.<code> for the code the order was answered with, and payment.errors.generic for a code with no sentence of its own, such as one added after this page. Do not show payment_details: it is the gateway's own wording, in English, and names the reason for a code whose sentence does not.

const texts = await fetch(base + '/v1/locales/en').then((res) => res.json());
// The order was answered { "payment_response_code": "3005", "payment_details": "Invalid Card Number" }
const errors = texts.payment.errors;
const message = errors[order.payment_response_code] ?? errors.generic;
// 'Check your card number and try again.'

A code added to the API is shown the generic sentence until it is added here, and adding it changes only the locale files: a client reads the sentence from the service, not from a copy of its own.

Codes

The decline is the API's name for the code. The message is the English one; every language is on its page under Languages.

Codes that give no reason

3007, 3008, 3009, 3012, 3013, 3015, 3017 are shown the plain decline, the same sentence as 3010 Hard Decline. The reason an issuer gives for these is not passed on to the shopper, as card networks and gateways advise; the shopper is asked to use a different card.