Refunds

Refund lifecycle for captured payments (multiple/partial refunds supported).

📄️ Mark a refund PROCESSED (manual)

Mark a refund PROCESSED (manual)

📄️ Mark a refund FAILED (re-attemptable)

Mark a refund FAILED (re-attemptable)

📄️ Mark a refund PROCESSING (manual)

Mark a refund PROCESSING (manual)

📄️ Issue a refund at the gateway (instant when supported)

Gateway PROCESSED → PROCESSED, PENDING → PROCESSING (settling), else FAILED. Idempotent.

📄️ Open a refund for a payment

Creates a PENDING refund. `amount` omitted = full remaining refundable amount; a partial amount is capped at what's left. Does not issue it — call /process.

📄️ Open a refund for a confirmed booking (guest cancellation)

Resolves the booking's captured payment and opens a PENDING refund against it. Use for cancellations, where refunds are partial and issued in phases; `amount` omitted = full remaining. Each call is a separate refund, capped at the remaining refundable amount.