Přejít na hlavní obsah

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.