FAQ

Which payment methods do customers see? Wave and Orange Money (via the Max It app or Orange Money QR code), as far as they’re enabled on the platform.

Do amounts have decimals? No. XOF has no subunit: 15000 means 15 000 F CFA. Floats are rejected.

How much does Xaalis charge? By default 1.5 % per successful payment, rounded up to the franc; your contract may differ. The exact fee and net are on every payment object. See Payments → Fees.

When is money available? As soon as a payment is succeeded, its net is in available and can be paid out.

How do I get my money? With a payout to a Wave wallet (Orange Money payouts are coming). Automatic daily settlement is planned.

The customer says they paid but the order isn’t marked paid. Check GET /v1/payments/{id}. If it’s processing, the provider hasn’t confirmed yet — wait for the webhook. If it’s succeeded, check GET /v1/webhook-deliveries for a delivery your server refused.

The customer was redirected to my success page — can I ship? No. Only a verified payment.succeeded webhook or a server-side GET proves payment. See Payments.

Can I refund a payment? Yes, in full, for Wave payments: POST /v1/payments/{id}/refunds. See Refunds.

Can I bill every month, or sell in instalments? Yes — Subscriptions and instalments. Each period the customer approves one payment from a link you send.

How long is a checkout link valid? 30 minutes. After that the payment becomes expired; create a new one.

How do I test without real money? Use your sk_test_ key: payments go to a test wallet where you choose the outcome. See Test mode.

I got 403 merchant_not_active. Your account hasn’t been activated for live payments yet. Keep integrating in test mode and contact Xaalis.