Refundace

Refundace se týkají zaúčtovaných nebo vyrovnaných plateb. U částečných refundací je amount ve stejných minor jednotkách jako původní měna.

Refundace použijte, když potřebujete vrátit prostředky za již zpracovanou platbu.

Plná nebo částečná refundace

const result = await client.refundPayment(paymentId, {
  amount: 10000, // částka v minor jednotkách
});

console.log(result.id, result.result);

Pole amount je povinné a odesílá se jako application/x-www-form-urlencoded podle očekávání GoPay endpointu.

Historie refundací

const refunds = await client.getPaymentRefunds(paymentId);

for (const refund of refunds) {
  console.log(refund.id, refund.state, refund.amount, refund.currency);
}

RefundHistoryItem obsahuje mimo jiné:

id
state
amount
currency
date_requested
date_last_change?

Doporučení

Ukládejte metadata refundací do databáze (ID refundace, částka, čas požadavku).
Částky držte v minor jednotkách pro konzistenci.
Navrhujte idempotentní workflow refundací, aby opakování požadavků nevytvářelo duplicity.