Errors

Qué crosses el wire

• Dónde it sits

  En el response a any call, y en el evento ese reports un later failure. El same code vocabulary es used en both places, so un decline caught synchronously y un renewal ese failed overnight son handled por one mapping.

• Qué comes back

  Un HTTP status ese classifies el failure broadly, y inside el body un typed code, un message written para un human reader, y un identificador de solicitud. El reference enumerates el codes; el message text es no part de el contract.

• Qué usted do con it

  Map each code a un action once, en one place: fail el request, retry it, ask el cliente para un different method, o escalate. Applications ese sucursal en message strings break el first time wording es improved.

Cuando a use it

• Handling declines

  Sucursal en el code, no el message string, que es written para humans y may change sin notice.

• Recovering recurring charges

  Soft declines feed el retry schedule; hard declines should stop el schedule y prompt el cliente para un new tarjeta instead de burning attempts.

• Deciding qué a show un cliente

  Some codes carry information el titular de la tarjeta puede act en, y some carry information el emisor expects usted no a disclose. El mapping decides que message el proceso de pago renders.

Cómo a implement Errors

Qué fails, y cómo usted find out

• Retrying a hard decline

  It cannot succeed, y repeated attempts en un closed o blocked cuenta son visible a el emisor. El recovery path es un new método de pago, no another attempt.

• Retrying sin el clave de idempotencia

  UN retry ese omits el key es un new request. If el first attempt actually landed, el cliente es charged twice y el duplicate es discovered en conciliación rather than en el till.

• Showing el raw message a el cliente

  Processor wording es written para un operator, no un titular de la tarjeta. Rendering it produces un proceso de pago ese tells people a Contacto un banco they do no banco con.

• Unknown codes falling through

  UN code usted have no mapped should fail closed y alert, no fall into el retry sucursal por incumplimiento de pago. New codes appear as el platform changes, y el changelog es dónde they son announced.

Sandbox versus production

• Usted choose el error

  Production declines depend en el emisor y cannot ser summoned en demand. En entorno de pruebas (sandbox) un documented tarjeta de prueba produces un specific code cada time, que es el solo way a write un test ese asserts en one.

• Platform failures son simulated too

  Timeouts y retryable failures puede ser provoked deliberately, so el idempotencia path gets exercised rather than assumed. Ese path es el one nobody tests until it costs un duplicate charge.

• El vocabulary es identical

  Entorno de pruebas (sandbox) does no use un reduced o friendlier code set. UN mapping built against entorno de pruebas (sandbox) codes es el mapping production needs, que es qué makes el exercise worth doing antes de go-live.