# Veyqo

> Payment orchestration for your existing provider accounts.

## Integration guides

- [Introduction](https://veyqo.org/docs-markdown/introduction.md): Your payment providers, behind one API. Start with a sandbox payment and take the same integration live.
- [Quick start](https://veyqo.org/docs-markdown/quickstart.md): Go from a connected sandbox provider to a payment your server can verify.
- [Authentication](https://veyqo.org/docs-markdown/authentication.md): Authenticate server requests and keep sandbox and live traffic separate.
- [Payments](https://veyqo.org/docs-markdown/payments.md): Initialize a charge, direct the customer to checkout, and confirm what happened.
- [Hosted checkout](https://veyqo.org/docs-markdown/checkout.md): Create checkout on your server, then open it from your website.
- [Webhooks](https://veyqo.org/docs-markdown/webhooks.md): Verify the sender, reject replays, and handle duplicate deliveries safely.
- [Refunds](https://veyqo.org/docs-markdown/refunds.md): Issue a full or partial refund through the provider that processed the payment.
- [Claude, Codex & AI agents](https://veyqo.org/docs-markdown/ai-agents.md): Give your assistant the API contract and payment rules before it writes the integration.
- [Errors & retries](https://veyqo.org/docs-markdown/errors.md): Understand failures and retry requests without repeating a charge.
- [Go live](https://veyqo.org/docs-markdown/go-live.md): Move the tested integration into a separately configured live environment.
- [API reference](https://veyqo.org/docs-markdown/api-reference.md): Endpoint definitions published by the Veyqo API, shared with the dashboard console.
- [Provider accounts & project routing](https://veyqo.org/docs-markdown/provider-accounts.md): Use separate credentials, shared credentials, or a mixture without mixing project data.
- [Idempotency & safe retries](https://veyqo.org/docs-markdown/idempotency.md): Prevent duplicate operations and recover safely from network uncertainty.
- [Pagination & rate limits](https://veyqo.org/docs-markdown/pagination.md): Read result pages and react to the real service limits.
- [Events & reconciliation](https://veyqo.org/docs-markdown/events.md): Recover missed notifications without confusing event snapshots with current payment state.
- [Payment links](https://veyqo.org/docs-markdown/payment-links.md): Create a fixed-price link in the dashboard and track the resulting checkout payments.
- [Browser checkout reference](https://veyqo.org/docs-markdown/browser-checkout.md): The separate public session surface used by the hosted page and checkout script.
- [Integration changelog](https://veyqo.org/docs-markdown/changelog.md): Contract corrections and recent integration behavior to account for.
- [POST Create a payment](https://veyqo.org/docs-markdown/api-payments-create.md): Starts a payment with the provider connected in this environment and returns a checkout URL. The amount is an integer in the smallest currency unit.
- [GET List payments](https://veyqo.org/docs-markdown/api-payments-list.md): List payments in this project environment, newest first. Only status, reference, created_after, created_before and pagination filters are implemented.
- [GET Retrieve a payment](https://veyqo.org/docs-markdown/api-payments-show.md): Retrieve by Veyqo payment ID or your merchant reference directly in the path. URL-encode references; use the Veyqo ID when a reference contains reserved URL characters.
- [POST Verify a payment](https://veyqo.org/docs-markdown/api-payments-verify.md): Asks the provider what actually happened and updates the payment. Use it when a webhook has not arrived — never trust a browser redirect alone.
- [POST Refund a payment](https://veyqo.org/docs-markdown/api-refunds-create.md): Full or partial. Omit `amount` to refund everything still refundable.
- [GET Retrieve a refund](https://veyqo.org/docs-markdown/api-refunds-show.md): The refund and the payment it belongs to.
- [GET List events](https://veyqo.org/docs-markdown/api-events-list.md): Every event Veyqo produced in this environment, newest first. Filter by `type`.
- [GET Retrieve an event](https://veyqo.org/docs-markdown/api-events-show.md): The normalized event, identical in shape whichever provider caused it.
- [POST Create a checkout session](https://veyqo.org/docs-markdown/api-checkout-sessions-create.md): Returns a checkout `url` where the customer pays without leaving Veyqo: by bank transfer, USSD or mobile money on the page itself, or by card in the gateway's own secure form over it. Created here with your secret key, the amount cannot be changed by the customer; open it with the JS SDK or redirect to `url`.
- [GET Retrieve a checkout session](https://veyqo.org/docs-markdown/api-checkout-sessions-show.md): Its status (`open`, `completed`, `expired`) and the payment behind it. A payment still waiting is verified with the provider before this answers.
- [GET List connected providers](https://veyqo.org/docs-markdown/api-providers-list.md): Lists provider connection rows for this environment, including status, health and explicitly public provider keys. Disabled or historical rows may be present; secret credentials are never returned.
- [POST Create a browser checkout session](https://veyqo.org/docs-markdown/api-browser-sessions-create.md): Starts a browser-defined checkout with a publishable key. The browser can change the amount, so reconcile against your server order. Success/cancel URL hosts must match the request Origin. Prefer server-created checkout for trusted pricing.
- [GET Read browser checkout state](https://veyqo.org/docs-markdown/api-browser-sessions-show.md): Possession of the session ID addresses this customer checkout. These endpoints support the hosted page and SDK; prefer those clients over reimplementing provider-specific actions.
- [POST Start a checkout method](https://veyqo.org/docs-markdown/api-browser-sessions-charge.md): Possession of the session ID addresses this customer checkout. These endpoints support the hosted page and SDK; prefer those clients over reimplementing provider-specific actions.
- [POST Submit a checkout OTP](https://veyqo.org/docs-markdown/api-browser-sessions-otp.md): Possession of the session ID addresses this customer checkout. These endpoints support the hosted page and SDK; prefer those clients over reimplementing provider-specific actions.
- [GET Read a payment link](https://veyqo.org/docs-markdown/api-browser-links-show.md): Possession of the payment link ID addresses this checkout. The fixed amount comes from the dashboard link, never the request body.
- [POST Start a payment-link session](https://veyqo.org/docs-markdown/api-browser-links-sessions.md): Possession of the payment link ID addresses this checkout. The fixed amount comes from the dashboard link, never the request body.

- [OpenAPI contract](https://veyqo.org/openapi.json)
- [JSON contract](https://veyqo.org/api-reference.json)
- [Postman collection](https://veyqo.org/postman.json)
- [Claude template](https://veyqo.org/ai/CLAUDE.md)
- [Codex template](https://veyqo.org/ai/AGENTS.md)
- [Full context](https://veyqo.org/llms-full.txt)
- [Live API reference](https://api.veyqo.org/docs/reference): Endpoint definitions (JSON).