Xaalis

Sandbox only: jump to the subscription's next billing event (next invoice, due date or end of grace) to test renewals without waiting.

Cancel now (voids the unpaid invoice if checkout hasn't started) or at the end of the current period.

Sandbox: create a spending wallet for an AI agent, with a per-payout cap and the only phone numbers it may pay. Fund it, then issue its ak_test_ key. In production a human sets up agent wallets.

Create a payment and get a hosted checkout_url to send to the customer (Wave or Orange Money). The payment is NOT paid until its status is 'succeeded' — check with xaalis_get_payment or a signed webhook, never the customer's redirect.

Sandbox only with a merchant key: send money from the merchant balance to a Wave or Orange Money number. In production, agents pay out only through an agent wallet key (ak_) with limits set by a human.

Bill a customer every day/week/month/year. Invoice 0 is issued at once: send its hosted_invoice_url (in latest_invoice) to the customer. Set billing_cycles (2–24) for an instalment plan that ends by itself.

Stop an agent wallet: its keys can no longer start payouts. Payouts already accepted finish normally. Safe to repeat.

Sandbox: move money from the merchant balance into an agent wallet. The wallet's balance is the agent's total spend limit.

Read an agent wallet's policy and balance.

The merchant's available balance (withdrawable) and money reserved for payouts in flight, in XOF.

Read a subscription invoice: status, amount, due date, and hosted_invoice_url (the stable link to send the customer).

Read a payment's current status, amount, fee and checkout link. 'succeeded' is the only proof the customer paid.

Read a payout's status (pending, processing, succeeded, failed).

Read a subscription: status, cycles paid, latest invoice.

Sandbox: issue the ak_test_ key an agent uses to pay out from this wallet. The secret is shown ONCE — store it in a secret store or env var right away. Retrying with the same idempotency_key never shows it again.

List the merchant's agent wallets and their policies.

List invoices, optionally for one subscription or by status.

List payments, newest first, optionally filtered by status.

List the merchant's payouts, newest first, with their status and recipient.

Read the refund of a payment, if any (a list of zero or one). Use it to check an uncertain refund instead of retrying.

List subscriptions, newest first, optionally by status.

Recent webhooks Xaalis sent to the merchant's endpoint, with status, attempts and the last error — use it to debug a webhook integration.

Sandbox: move unreserved money from an agent wallet back to the merchant balance.

Send the FULL amount of a succeeded Wave payment back to the customer (no partial refunds). The merchant's available balance must cover it. One refund per payment; the same idempotency_key returns the same refund.

Create a Xaalis SANDBOX merchant account and get its test secret key (sk_test_…) and webhook secret, with no human step. Sandbox only: no real money, simulated wallets. Going live later needs a human (KYC and approval). Store the returned secrets in environment variables, never in code.

Search the official Xaalis documentation (payments, webhooks, payouts, refunds, subscriptions, SDKs, errors, go-live). Use it before guessing how an endpoint behaves.

Sandbox only: make a test payment succeed or fail as if the customer had paid (or declined) in their wallet. Triggers the same webhooks as a real payment.

Start here. Shows which Xaalis key is connected (none, merchant test/live, agent wallet), its mode, the account or wallet it belongs to, and which tools it unlocks.