Refundácie a chargebacky

Notifikácie o refundácii a spore z každého obchodu sa dekódujú do výsledku ResultType::Refund a ukladajú sa ako plnohodnotný PurchaseRefund:

handle() uloží refundáciu idempotentne, prepojí ju s pôvodným nákupom (párovaným podľa poskytovateľa a identifikátora transakcie alebo identifikátora u poskytovateľa), prepne tento nákup na Status::Refunded a spustí PurchaseRefunded, pri sporoch ChargebackReceived. Refundácia aktuálneho obdobia predplatného — transakcie Apple, v ktorej predplatné práve je, alebo jeho poslednej objednávky v Google — a zrušené predplatné Google prepnú na Refunded aj Subscription, takže prestane byť aktívne; refundácia staršieho obdobia ho nechá tak. Každá refundovaná transakcia Apple má vlastný PurchaseRefund, takže refundácie dvoch období sú dva záznamy a dve udalosti; refunded_at refundácie Apple je jej revocationDate. Čiastočná refundácia (platba v Stripe, ktorá nie je refundovaná celá, čiastočné storno podľa množstva v Google) sa uloží a spustí PurchaseRefunded, nákup však ponechá v stave Completed:

use RoundlyConsulting\Purchases\Models\PurchaseRefund;

$purchase->refunds;                    // HasMany<PurchaseRefund>
$purchase->status;                     // Status::Refunded once a refund is matched

PurchaseRefund::chargebacks()->get();  // disputes only

$refund->chargeback;                   // bool
$refund->reason;                       // ?string
$refund->price;                        // ?Money — the refunded amount
$refund->refunded_at;                  // ?Carbon
$refund->purchase;                     // the Purchase it reverses, when matched

reason obsahuje to, čo nahlási obchod — pole reason zo Stripe, typ notifikácie Apple, typ refundácie alebo názov notifikácie Google. Pomerná refundácia Apple zaznamená len vrátenú časť; odvolanie cez Family Sharing nezaznamená žiadnu sumu.

Refundácie Stripe sú priebežný súčet

Všetky refundácie jednej platby v Stripe zdieľajú jeden PurchaseRefund kľúčovaný podľa jej PaymentIntent a jeho cena je kumulatívna suma amount_refunded danej platby. Každá ďalšia čiastočná refundácia znova spustí PurchaseRefunded s novým súčtom, nie so sumou tejto refundácie — $event->refund->price preto naprieč udalosťami nikdy nesčítavajte; čítajte ho ako „doteraz vrátené“. Záznam refundácie Apple predstavuje jednu refundovanú transakciu, záznam Google jednu stornovanú objednávku.