Captures, cancellations and refunds

​

Automatic or manual capture

await kalixo.payments.capture('pay_...', { amount: 600 }); // partial capture
await kalixo.payments.capture('pay_...');                  // the remaining amount

• A capture is pending until payment.captured, payment.partially_captured or capture.failed arrives.
• The total captured can never exceed the authorised amount (amount_too_large).
• Not every payment method supports separate or partial captures. Authorisations expire after a few days depending on the method; capture as soon as you can.

​

Cancel

await kalixo.payments.cancel('pay_...');

​

Refund

await kalixo.refunds.create({ payment: 'pay_...', amount: 300, reason: 'requested_by_customer' });
await kalixo.refunds.create({ payment: 'pay_...' }); // the rest of the captured amount

• Multiple partial refunds are allowed. The total refunded can never exceed the captured amount, even when requests arrive at the same time.
• A refund is pending until refund.succeeded or refund.failed.
• Disputed payments cannot be refunded (payment_disputed); the dispute decides the outcome.
• With automatic capture, wait for payment.captured before refunding.