PayLumiaDevelopers
⌘K

PayLumia Partner API · v1 · Hosted

Charge any mobile line with one hosted checkout.

Create a payment on your server, send the subscriber to pay.paylumia.com, and receive a signed webhook when the operator has charged the line. No card, no account: consent, the code, localisation and operator rules are ours to handle.

Start the quickstart Build with AIRequest sandbox keys
Hosted payment flow — your server, pay.paylumia.com, operator, webhook

Why PayLumia

  • One integration

    One API and one hosted checkout, whatever the operator behind it. Consent rules per operator are ours to maintain.

  • Money you can trust

    Signed webhooks, idempotent creates and integer amounts. A retry never charges twice.

  • Built for subscriptions

    Trials, renewals, grace and cancellation run on the platform. You react to events.

  • AI-ready docs

    An installable skill for Claude Code and Cursor, llms.txt and a copy button on every page.

Choose your integration

Every path uses the same payment resource and the same webhooks.

Most partnersHosted checkout · redirectSend the subscriber to pay.paylumia.com and back. Works in every browser and in-app webview.POST /v1/payments · presentation: redirectBranded flowHosted checkout · embeddedMount the checkout inside your own page. Consent screens stay PayLumia’s, the frame is yours.presentation: embeddedRecurring revenueSubscriptionsDaily, weekly or monthly offers with trials. Renewals and grace are platform-managed.SUBSCRIPTION offers · entitlement.* events

Getting started

  1. 01

    Get sandbox keys

    Tell us what you sell. We set up your application, first offers and sandbox credentials (plm_test_, mock).

    Request access →
  2. 02

    Take a test payment

    Token, hosted payment, webhook: the quickstart takes about thirty minutes against sandbox.

    Open the quickstart →
  3. 03

    Test every path

    Success, decline, expiry, cancellation and duplicate webhooks in sandbox before go-live.

    See what to test →
  4. 04

    Go live

    Pass the checklist in sandbox, get reviewed, receive production credentials.

    Go-live checklist →
New · AI-assisted onboardingLet your coding agent do the integration.Install the paylumia-integration skill in Claude Code or Cursor. It scopes your offer, writes the token client, the payment call and a verified webhook handler, then checks you against the go-live list.Get the skill

Environments

APICheckoutClient ID
Sandboxhttps://api.sandbox.paylumia.comhttps://pay.sandbox.paylumia.complm_test_ · mock
Productionhttps://api.paylumia.comhttps://pay.paylumia.complm_live_ · live Orange

Conventions

TokenPOST /oauth2/token
Success{ "success": true, "data": … }
ErrorsXXX-### codes, with retry hints
MoneyIntegers in minor units (TND: millimes)

Need a hand?

The Hadruvo integration team sets up your application, joins your testing sessions and runs the go-live review.

Contact the team