The two cash fields of payments.paymentMethods[] in the events that carry the V4 order snapshot (order.opened, order.completed, order.invoiced, order.cancelled, order.reversed). The event versions do not change.

• customerCashAmount is a number and carries the real amount. Until 24 September 2026 it always travelled as the string "0", even on cash payments. Now it is the cash the customer handed over: for a 22.9 bill paid with a 50 note, 50; 0 on methods that are not cash.
• changeAmount is listed — the change the till gave back, as a number: 27.1 in the example above, 0 on methods that are not cash, null when the till did not send it. It already travelled in the events; it was missing from the reference.
• If your consumer checked that customerCashAmount is a string, it now fails. Read it as a number. Events of orders injected before 24 September still carry "0", so a replay of an older order does too.

Updated in EN / ES / PT.

Español

25 de septiembre de 2026 — Efectivo entregado y vuelto en los eventos de la orden

Los dos campos de efectivo de payments.paymentMethods[] en los eventos que llevan el snapshot V4 de la orden (order.opened, order.completed, order.invoiced, order.cancelled, order.reversed). Las versiones de los eventos no cambian.

• customerCashAmount es un número y trae el monto real. Hasta el 24 de septiembre de 2026 viajaba siempre como el texto "0", incluso en pagos en efectivo. Ahora es el efectivo que entregó el cliente: para una cuenta de 22.9 pagada con un billete de 50, 50; 0 en los medios que no son efectivo.
• changeAmount figura en la referencia — el vuelto que entregó la caja, como número: 27.1 en el ejemplo anterior, 0 en los medios que no son efectivo, null si la caja no lo mandó. Ya viajaba en los eventos; faltaba en la referencia.
• Si tu consumidor validaba que customerCashAmount fuera texto, ahora falla. Leelo como número. Los eventos de órdenes inyectadas antes del 24 de septiembre siguen trayendo "0", así que un reenvío de una orden vieja también.

Actualizado en EN / ES / PT.

Português

25 de setembro de 2026 — Dinheiro entregue e troco nos eventos do pedido

Os dois campos de dinheiro de payments.paymentMethods[] nos eventos que levam o snapshot V4 do pedido (order.opened, order.completed, order.invoiced, order.cancelled, order.reversed). As versões dos eventos não mudam.

• customerCashAmount é um número e traz o valor real. Até 24 de setembro de 2026 trafegava sempre como o texto "0", inclusive em pagamentos em dinheiro. Agora é o dinheiro entregue pelo cliente: para uma conta de 22.9 paga com uma nota de 50, 50; 0 nos meios que não são dinheiro.
• changeAmount entra na referência — o troco entregue pelo caixa, como número: 27.1 no exemplo anterior, 0 nos meios que não são dinheiro, null quando o caixa não o enviou. Já trafegava nos eventos; faltava na referência.
• Se o seu consumidor validava que customerCashAmount fosse texto, agora falha. Leia como número. Os eventos de pedidos injetados antes de 24 de setembro continuam trazendo "0", então um reenvio de um pedido antigo também.

Atualizado em EN / ES / PT.

Read the full changelog · Ver el registro completo · Ver o registro completo