In one sentence
If you already have Stripe integration code, you can make it work with Simiz by changing only the base URL and API key. No call rewrites are required for the most common endpoints.Covered endpoints
Our compatibility layer exposes routes aligned with the Stripe schema for the following operations:| Stripe endpoint | Simiz endpoint | Status |
|---|---|---|
POST /v1/payment_intents | POST /v1/compat/stripe/payment_intents | Stable |
GET /v1/payment_intents/:id | GET /v1/compat/stripe/payment_intents/:id | Stable |
POST /v1/customers | POST /v1/compat/stripe/customers | Stable |
POST /v1/refunds | POST /v1/compat/stripe/refunds | Stable |
POST /v1/webhook_endpoints | (dashboard config) | Recommended via UI |
Key differences
- Currencies: Simiz is multi-XOF/XAF/USD/EUR. The
currencyfield keeps the same Stripe semantics but also accepts Africa-region codes. - Payment methods: in addition to
card, Simiz exposesmobile_money(MTN, Orange, Moov, Wave). See core-concepts/payments/mobile-money. - Webhooks: signature follows the same HMAC-SHA256 as Stripe, with the
Simiz-Signatureheader. See core-concepts/webhooks/signature-verification.
Known limitations
- No coverage for Stripe Connect Express / Custom platform products (use our Marketplace Pro instead).
- No coverage for
Issuing/ issued cards. - No support for
Klarna/Affirm(no demand in the Francophone Africa region).
Migration steps
- Request a Simiz API key in Dashboard → API → Keys.
- Replace
https://api.stripe.com/v1/withhttps://api.simiz.io/v1/compat/stripe/. - Replace your
sk_live_*key with yoursmz_live_*key. - Test in sandbox (see guides/sandbox-testing).
- Update your webhook URL if you use one.

