# Payoes

> Developer-first payment infrastructure for the Stellar ecosystem.

## Docs

- [List checkout sessions](https://docs.payoes.com/api-reference/checkout-sessions/list-checkout-sessions.md)
- [Retrieve a checkout session](https://docs.payoes.com/api-reference/checkout-sessions/retrieve-a-checkout-session.md)
- [Create a customer](https://docs.payoes.com/api-reference/customers/create-a-customer.md)
- [List customers](https://docs.payoes.com/api-reference/customers/list-customers.md): Returns customers for the organization and environment tied to the API key.
- [Retrieve a customer](https://docs.payoes.com/api-reference/customers/retrieve-a-customer.md): Returns the customer and their payment history in the current environment.
- [Create an invoice](https://docs.payoes.com/api-reference/invoices/create-an-invoice.md): Creates a draft invoice for a customer. Finalize the invoice to generate a checkout session and payment link. Use the dashboard to send invoices by email.
- [Finalize an invoice](https://docs.payoes.com/api-reference/invoices/finalize-an-invoice.md): Moves a draft invoice to `open`, creates a checkout session, and returns the checkout URL for the customer to pay.
- [List invoices](https://docs.payoes.com/api-reference/invoices/list-invoices.md)
- [Retrieve an invoice](https://docs.payoes.com/api-reference/invoices/retrieve-an-invoice.md)
- [API overview](https://docs.payoes.com/api-reference/overview.md): Payoes REST API conventions, base URL, authentication, and available resources.
- [Create a payment link](https://docs.payoes.com/api-reference/payment-links/create-a-payment-link.md): Creates a reusable payment link. Each visit starts a new checkout session. Share the returned `url` (`/c/plink_...`). Each visit redirects to a new checkout session.
- [List payment links](https://docs.payoes.com/api-reference/payment-links/list-payment-links.md)
- [Retrieve a payment link](https://docs.payoes.com/api-reference/payment-links/retrieve-a-payment-link.md)
- [Create a payment](https://docs.payoes.com/api-reference/payments/create-a-payment.md): Creates a pending payment and returns a hosted checkout URL. The settlement wallet and Stellar network are resolved from your organization settings.
- [List payments](https://docs.payoes.com/api-reference/payments/list-payments.md): Returns payments for the organization and environment tied to the API key.
- [Retrieve a payment](https://docs.payoes.com/api-reference/payments/retrieve-a-payment.md)
- [Authentication](https://docs.payoes.com/guides/authentication.md): Authenticate Payoes API requests with Bearer API keys.
- [Hosted checkout](https://docs.payoes.com/guides/checkout.md): How the Payoes checkout page works and how customers pay with Stellar wallets.
- [Core concepts](https://docs.payoes.com/guides/concepts.md): Merchants, customers, payments, checkout, and how they fit together.
- [Customers](https://docs.payoes.com/guides/customers.md): Organize payers, link payments, and auto-create customers from checkout wallets.
- [Environments](https://docs.payoes.com/guides/environments.md): Sandbox and production modes for safe testing on Stellar testnet.
- [Errors](https://docs.payoes.com/guides/errors.md): Common payment and Stellar network errors and how to resolve them.
- [Settlement wallet](https://docs.payoes.com/guides/settlement-wallet.md): Configure the Stellar address where customer payments are sent.
- [Webhooks](https://docs.payoes.com/guides/webhooks.md): Receive signed HTTP notifications when payment events occur.
- [Introduction](https://docs.payoes.com/introduction.md): Accept USDC and XLM payments on Stellar without building blockchain infrastructure from scratch.
- [Environment variables](https://docs.payoes.com/local-setup/environment-variables.md): Reference for apps/web/.env.local when running Payoes locally.
- [Getting started](https://docs.payoes.com/local-setup/getting-started.md): Step-by-step guide to run Payoes on your machine from a fresh clone.
- [KYC verification (Persona)](https://docs.payoes.com/local-setup/kyc-verification.md): Set up automated identity verification for production mode using Persona.
- [Overview](https://docs.payoes.com/local-setup/overview.md): Run the Payoes web app and API on your machine for development.
- [Soroban escrow setup](https://docs.payoes.com/local-setup/soroban-escrow-setup.md): Deploy and configure the Payoes Soroban escrow contract for local checkout.
- [Webhook retry worker](https://docs.payoes.com/local-setup/webhook-retry-worker.md): Schedule webhook retries when you self-host Payoes.
- [Quickstart](https://docs.payoes.com/quickstart.md): Create your first Stellar payment with the Payoes API.

## OpenAPI Specs

- [v1](https://docs.payoes.com/openapi/v1.yaml)