Migration Guide

Move from Stripe, PayPal, or an in-house rail without breaking your existing integrations.

Updated Jul 15, 2026API 2026-07-01 Edit on GitHub Report an issue

Concept mapping

Field	Type	Description
Stripe PaymentIntent	→ Payment	Same 3-state lifecycle. Field names are 1:1 for amount, currency, customer.
Stripe Customer	→ Customer	Fields map directly. Import via CSV.
Stripe Payout	→ Settlement	Batch semantics are identical.
PayPal Order	→ Payment (manual capture)	Use capture_method: 'manual' for authorize/capture flows.

1Dual-write
Send new payments to both systems for 2 weeks and reconcile daily.
2Cutover reads
Switch reads to Korven once reconciliation reaches zero delta.
3Retire the old rail
Stop writes; keep old system in read-only mode for support cases.