# PayLumia Developers

> Carrier billing through one hosted checkout. Create a payment on your server, send the subscriber to pay.paylumia.com, receive a signed webhook when the operator has charged the line. PayLumia is a Hadruvo platform.

An installable agent skill is available: https://developers.hadruvo.com/downloads/paylumia-integration.zip (see https://developers.hadruvo.com/ai).
Full text for LLMs: https://developers.hadruvo.com/llms-full.txt

## Get started

- [Overview](https://developers.hadruvo.com/): What PayLumia does, integration paths and how to begin.
- [Quickstart](https://developers.hadruvo.com/quickstart): A sandbox payment end to end in five steps.
- [Build with AI](https://developers.hadruvo.com/ai): Install the PayLumia skill in your coding agent; llms.txt and full-text exports.
- [Authentication](https://developers.hadruvo.com/authentication): OAuth 2.0 client credentials, headers and secret handling.
- [Environments & go-live](https://developers.hadruvo.com/go-live): Sandbox and production URLs, the go-live checklist and approval.

## Hosted checkout

- [Create a payment](https://developers.hadruvo.com/hosted-checkout): POST /v1/payments in HOSTED mode: fields, rules and response.
- [Checkout experience](https://developers.hadruvo.com/checkout-experience): Redirect or embedded, prefill, consent methods and the return.
- [Payment lifecycle](https://developers.hadruvo.com/payment-lifecycle): Payment statuses, reading and canceling a payment.
- [Webhooks](https://developers.hadruvo.com/webhooks): Events, payload, signature verification and delivery.
- [Subscriptions](https://developers.hadruvo.com/subscriptions): Trials, renewals, cancel and resume, statuses.

## Operate

- [Sandbox & testing](https://developers.hadruvo.com/testing): What to test in sandbox before asking for a go-live review.
- [Operators & coverage](https://developers.hadruvo.com/coverage): Where PayLumia charges today, currencies and number formats.

## Reference

- [API reference](https://developers.hadruvo.com/api-reference): Every endpoint of the hosted surface with requests and responses.
- [Errors](https://developers.hadruvo.com/errors): Error shape, common codes and retry guidance.
- [FAQ](https://developers.hadruvo.com/faq): Short answers to common integration questions.
- [Need help?](https://developers.hadruvo.com/support): How to reach the integration team.

## Optional

- [OpenAPI 3.1](https://developers.hadruvo.com/paylumia-hosted.openapi.yaml)