# SimplePay Docs

> Documentacion para integrar SimplePay: pagos hospedados, Payment Links, Bookable Payments, webhooks, politica de pagos, referencia OpenAPI y contexto listo para agentes.

## Docs

- [Context pack](https://docs.simplepay.mx/agents/context-pack.md): Bloque de contexto compacto para pegar en un LLM antes de pedirle que implemente SimplePay correctamente.
- [LLMs y agentes](https://docs.simplepay.mx/agents/llm-guide.md): Como usar las docs de SimplePay con LLMs, Cursor, Claude, ChatGPT, MCP, Markdown export, llms.txt y skill.md sin perder contexto ni seguridad.
- [Create an availability schedule](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/create-availability-schedule.md): Referencia detallada para POST /v1/bookable-payments/availability_schedules.
- [Create an availability schedule override](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/create-availability-schedule-override.md): Referencia detallada para POST /v1/bookable-payments/availability_schedules/{id}/overrides.
- [Create an availability schedule rule](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/create-availability-schedule-rule.md): Referencia detallada para POST /v1/bookable-payments/availability_schedules/{id}/rules.
- [Create a booking blackout period](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/create-booking-blackout.md): Referencia detallada para POST /v1/bookable-payments/blackouts.
- [Delete an availability schedule override](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/delete-availability-schedule-override.md): Referencia detallada para DELETE /v1/bookable-payments/availability_schedules/{id}/overrides/{override_id}.
- [Delete a booking blackout period](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/delete-booking-blackout.md): Referencia detallada para DELETE /v1/bookable-payments/blackouts/{id}.
- [Retrieve an availability schedule](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/get-availability-schedule.md): Referencia detallada para GET /v1/bookable-payments/availability_schedules/{id}.
- [Retrieve a booking blackout period](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/get-booking-blackout.md): Referencia detallada para GET /v1/bookable-payments/blackouts/{id}.
- [List availability schedules](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/list-availability-schedules.md): Referencia detallada para GET /v1/bookable-payments/availability_schedules.
- [List booking blackout periods](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/list-booking-blackouts.md): Referencia detallada para GET /v1/bookable-payments/blackouts.
- [Update an availability schedule](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/update-availability-schedule.md): Referencia detallada para PATCH /v1/bookable-payments/availability_schedules/{id}.
- [Update an availability schedule override](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/update-availability-schedule-override.md): Referencia detallada para PATCH /v1/bookable-payments/availability_schedules/{id}/overrides/{override_id}.
- [Update an availability schedule rule](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/update-availability-schedule-rule.md): Referencia detallada para PATCH /v1/bookable-payments/availability_schedules/{id}/rules/{rule_id}.
- [Update a booking blackout period](https://docs.simplepay.mx/api-reference/endpoints/bookable-availability/update-booking-blackout.md): Referencia detallada para PATCH /v1/bookable-payments/blackouts/{id}.
- [Cancel a booking](https://docs.simplepay.mx/api-reference/endpoints/bookable-bookings/cancel-booking.md): Referencia detallada para POST /v1/bookable-payments/bookings/{id}/cancel.
- [Hold a booking slot and create a SimplePay Checkout Session](https://docs.simplepay.mx/api-reference/endpoints/bookable-bookings/create-booking-checkout.md): Referencia detallada para POST /v1/bookable-payments/bookings.
- [Create a temporary booking hold](https://docs.simplepay.mx/api-reference/endpoints/bookable-bookings/create-booking-hold.md): Referencia detallada para POST /v1/bookable-payments/holds.
- [Convert a booking hold into a SimplePay Checkout Session](https://docs.simplepay.mx/api-reference/endpoints/bookable-bookings/create-checkout-for-booking-hold.md): Referencia detallada para POST /v1/bookable-payments/holds/{id}/payment.
- [Retrieve a booking](https://docs.simplepay.mx/api-reference/endpoints/bookable-bookings/get-booking.md): Referencia detallada para GET /v1/bookable-payments/bookings/{id}.
- [List tenant bookings](https://docs.simplepay.mx/api-reference/endpoints/bookable-bookings/list-bookings.md): Referencia detallada para GET /v1/bookings.
- [Mark a confirmed booking as no-show](https://docs.simplepay.mx/api-reference/endpoints/bookable-bookings/mark-booking-no-show.md): Referencia detallada para POST /v1/bookable-payments/bookings/{id}/no_show.
- [Refund a paid booking](https://docs.simplepay.mx/api-reference/endpoints/bookable-bookings/refund-booking.md): Referencia detallada para POST /v1/bookable-payments/bookings/{id}/refund.
- [Release a temporary booking hold](https://docs.simplepay.mx/api-reference/endpoints/bookable-bookings/release-booking-hold.md): Referencia detallada para POST /v1/bookable-payments/holds/{id}/release.
- [Reschedule a booking](https://docs.simplepay.mx/api-reference/endpoints/bookable-bookings/reschedule-booking.md): Referencia detallada para POST /v1/bookable-payments/bookings/{id}/reschedule.
- [Archive a booking event type](https://docs.simplepay.mx/api-reference/endpoints/bookable-event-types/archive-booking-event-type.md): Referencia detallada para POST /v1/bookable-payments/event_types/{id_or_slug}/archive.
- [Attach a booking resource to a booking event type](https://docs.simplepay.mx/api-reference/endpoints/bookable-event-types/attach-booking-event-type-resource.md): Referencia detallada para POST /v1/bookable-payments/event_types/{id_or_slug}/resources.
- [Attach an availability schedule to a booking event type](https://docs.simplepay.mx/api-reference/endpoints/bookable-event-types/attach-booking-event-type-schedule.md): Referencia detallada para POST /v1/bookable-payments/event_types/{id_or_slug}/schedules.
- [Create a booking event type](https://docs.simplepay.mx/api-reference/endpoints/bookable-event-types/create-booking-event-type.md): Referencia detallada para POST /v1/bookable-payments/event_types.
- [Detach a booking resource from a booking event type](https://docs.simplepay.mx/api-reference/endpoints/bookable-event-types/detach-booking-event-type-resource.md): Referencia detallada para DELETE /v1/bookable-payments/event_types/{id_or_slug}/resources/{resource_id}.
- [Detach an availability schedule from a booking event type](https://docs.simplepay.mx/api-reference/endpoints/bookable-event-types/detach-booking-event-type-schedule.md): Referencia detallada para DELETE /v1/bookable-payments/event_types/{id_or_slug}/schedules/{schedule_id}.
- [Retrieve a booking event type](https://docs.simplepay.mx/api-reference/endpoints/bookable-event-types/get-booking-event-type.md): Referencia detallada para GET /v1/bookable-payments/event_types/{id_or_slug}.
- [List available booking slots for a booking event type](https://docs.simplepay.mx/api-reference/endpoints/bookable-event-types/list-booking-event-type-slots.md): Referencia detallada para GET /v1/bookable-payments/event_types/{id_or_slug}/slots.
- [List booking event types](https://docs.simplepay.mx/api-reference/endpoints/bookable-event-types/list-booking-event-types.md): Referencia detallada para GET /v1/bookable-payments/event_types.
- [Update a booking event type](https://docs.simplepay.mx/api-reference/endpoints/bookable-event-types/update-booking-event-type.md): Referencia detallada para PATCH /v1/bookable-payments/event_types/{id_or_slug}.
- [Create a booking resource](https://docs.simplepay.mx/api-reference/endpoints/bookable-resources/create-booking-resource.md): Referencia detallada para POST /v1/bookable-payments/resources.
- [Retrieve a booking resource](https://docs.simplepay.mx/api-reference/endpoints/bookable-resources/get-booking-resource.md): Referencia detallada para GET /v1/bookable-payments/resources/{id}.
- [List booking resources](https://docs.simplepay.mx/api-reference/endpoints/bookable-resources/list-booking-resources.md): Referencia detallada para GET /v1/bookable-payments/resources.
- [Update a booking resource](https://docs.simplepay.mx/api-reference/endpoints/bookable-resources/update-booking-resource.md): Referencia detallada para PATCH /v1/bookable-payments/resources/{id}.
- [Create a Bookable Payments scheduling setup preset](https://docs.simplepay.mx/api-reference/endpoints/bookable-setup/create-bookable-payments-setup.md): Referencia detallada para POST /v1/bookable-payments/setup.
- [Get Bookable Payments integration primitives and blueprints](https://docs.simplepay.mx/api-reference/endpoints/bookable-setup/get-bookable-payments-config.md): Referencia detallada para GET /v1/bookable-payments/config.
- [Inspect Bookable Payments scheduling integration readiness](https://docs.simplepay.mx/api-reference/endpoints/bookable-setup/get-bookable-payments-preflight.md): Referencia detallada para GET /v1/bookable-payments/preflight.
- [Retrieve a public catalog CMS product](https://docs.simplepay.mx/api-reference/endpoints/catalog/get-catalog-product.md): Referencia detallada para GET /v1/catalog/products/{id_or_slug}.
- [List public catalog CMS categories](https://docs.simplepay.mx/api-reference/endpoints/catalog/list-catalog-categories.md): Referencia detallada para GET /v1/catalog/categories.
- [List public catalog CMS products for a category](https://docs.simplepay.mx/api-reference/endpoints/catalog/list-catalog-category-products.md): Referencia detallada para GET /v1/catalog/categories/{id_or_slug}/products.
- [List public catalog CMS category tree](https://docs.simplepay.mx/api-reference/endpoints/catalog/list-catalog-category-tree.md): Referencia detallada para GET /v1/catalog/categories/tree.
- [List public catalog CMS products](https://docs.simplepay.mx/api-reference/endpoints/catalog/list-catalog-products.md): Referencia detallada para GET /v1/catalog/products.
- [Create a hosted Checkout Session](https://docs.simplepay.mx/api-reference/endpoints/checkout/create-checkout-session.md): Referencia detallada para POST /v1/hosted-checkout/sessions.
- [Retrieve a Checkout Session](https://docs.simplepay.mx/api-reference/endpoints/checkout/get-checkout-session.md): Referencia detallada para GET /v1/hosted-checkout/sessions/{id}.
- [Add an address](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/add-customer-hub-address.md): Referencia detallada para POST /v1/customer-hub/customers/{customer_id}/addresses.
- [Add a contact](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/add-customer-hub-contact.md): Referencia detallada para POST /v1/customer-hub/customers/{customer_id}/contacts.
- [Add an external ref](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/add-customer-hub-external-ref.md): Referencia detallada para POST /v1/customer-hub/customers/{customer_id}/external-refs.
- [Add a note](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/add-customer-hub-note.md): Referencia detallada para POST /v1/customer-hub/customers/{customer_id}/notes.
- [Add a relationship](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/add-customer-hub-relationship.md): Referencia detallada para POST /v1/customer-hub/customers/{customer_id}/relationships.
- [Create a customer](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/create-customer-hub-customer.md): Referencia detallada para POST /v1/customer-hub/customers.
- [Create an import](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/create-customer-hub-import.md): Referencia detallada para POST /v1/customer-hub/imports.
- [Create a sync source](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/create-customer-hub-sync-source.md): Referencia detallada para POST /v1/customer-hub/sync-sources.
- [Create a tag](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/create-customer-hub-tag.md): Referencia detallada para POST /v1/customer-hub/tags.
- [Get a customer](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/get-customer-hub-customer.md): Referencia detallada para GET /v1/customer-hub/customers/{customer_id}.
- [Get an import](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/get-customer-hub-import.md): Referencia detallada para GET /v1/customer-hub/imports/{import_id}.
- [List timeline events](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/get-customer-hub-timeline.md): Referencia detallada para GET /v1/customer-hub/customers/{customer_id}/timeline.
- [Link to SimplePay identity/tenant](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/link-customer-hub-simplepay.md): Referencia detallada para POST /v1/customer-hub/customers/{customer_id}/link-simplepay.
- [List customers](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/list-customer-hub-customers.md): Referencia detallada para GET /v1/customer-hub/customers.
- [List sync sources](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/list-customer-hub-sync-sources.md): Referencia detallada para GET /v1/customer-hub/sync-sources.
- [List tags](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/list-customer-hub-tags.md): Referencia detallada para GET /v1/customer-hub/tags.
- [Trigger provider projection](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/sync-customer-hub-provider.md): Referencia detallada para POST /v1/customer-hub/customers/{customer_id}/provider-sync.
- [Update an address](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/update-customer-hub-address.md): Referencia detallada para PATCH /v1/customer-hub/customers/{customer_id}/addresses/{address_id}.
- [Update a contact](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/update-customer-hub-contact.md): Referencia detallada para PATCH /v1/customer-hub/customers/{customer_id}/contacts/{contact_id}.
- [Update a customer](https://docs.simplepay.mx/api-reference/endpoints/customer-hub/update-customer-hub-customer.md): Referencia detallada para PATCH /v1/customer-hub/customers/{customer_id}.
- [Get OpenAPI spec](https://docs.simplepay.mx/api-reference/endpoints/meta/get-open-api-spec.md): Referencia detallada para GET /openapi.json.
- [Create a Payment Link](https://docs.simplepay.mx/api-reference/endpoints/payment-links/create-payment-link.md): Referencia detallada para POST /v1/payment-links.
- [Retrieve a Payment Link](https://docs.simplepay.mx/api-reference/endpoints/payment-links/get-payment-link.md): Referencia detallada para GET /v1/payment-links/{id}.
- [Evaluate a proposed payment against the tenant's effective SimplePay payment policy](https://docs.simplepay.mx/api-reference/endpoints/payment-policy/evaluate-payment-policy.md): Referencia detallada para POST /v1/payment-policy/evaluate.
- [Retrieve the effective SimplePay payment policy for the tenant environment](https://docs.simplepay.mx/api-reference/endpoints/payment-policy/get-effective-payment-policy.md): Referencia detallada para GET /v1/payment-policy/effective.
- [Create a tenant product](https://docs.simplepay.mx/api-reference/endpoints/products/create-product.md): Referencia detallada para POST /v1/products.
- [Create an enterprise product booking from a hold](https://docs.simplepay.mx/api-reference/endpoints/products/create-product-inventory-booking.md): Referencia detallada para POST /v1/products/{id}/bookings.
- [Create an enterprise product inventory hold](https://docs.simplepay.mx/api-reference/endpoints/products/create-product-inventory-hold.md): Referencia detallada para POST /v1/products/{id}/holds.
- [Retrieve a tenant product](https://docs.simplepay.mx/api-reference/endpoints/products/get-product.md): Referencia detallada para GET /v1/products/{id}.
- [List enterprise product availability](https://docs.simplepay.mx/api-reference/endpoints/products/list-product-availability.md): Referencia detallada para GET /v1/products/{id}/availability.
- [List enterprise product offers](https://docs.simplepay.mx/api-reference/endpoints/products/list-product-offers.md): Referencia detallada para GET /v1/products/{id}/offers.
- [List available booking slots for a product](https://docs.simplepay.mx/api-reference/endpoints/products/list-product-slots.md): Referencia detallada para GET /v1/products/{id}/slots.
- [List tenant products](https://docs.simplepay.mx/api-reference/endpoints/products/list-products.md): Referencia detallada para GET /v1/products.
- [Update a tenant product](https://docs.simplepay.mx/api-reference/endpoints/products/update-product.md): Referencia detallada para PATCH /v1/products/{id}.
- [Create a new active tenant bundle version](https://docs.simplepay.mx/api-reference/endpoints/products/upsert-product-bundle.md): Referencia detallada para PUT /v1/products/{id}/bundle.
- [Replace consumable package grant definitions](https://docs.simplepay.mx/api-reference/endpoints/products/upsert-product-package-grants.md): Referencia detallada para PUT /v1/products/{id}/package-grants.
- [Create a refund](https://docs.simplepay.mx/api-reference/endpoints/refunds/create-refund.md): Referencia detallada para POST /v1/refunds.
- [Retrieve a refund](https://docs.simplepay.mx/api-reference/endpoints/refunds/get-refund.md): Referencia detallada para GET /v1/refunds/{id}.
- [List refunds](https://docs.simplepay.mx/api-reference/endpoints/refunds/list-refunds.md): Referencia detallada para GET /v1/refunds.
- [Create a webhook endpoint](https://docs.simplepay.mx/api-reference/endpoints/webhooks-events/create-webhook-endpoint.md): Referencia detallada para POST /v1/webhook_endpoints.
- [Delete a webhook endpoint](https://docs.simplepay.mx/api-reference/endpoints/webhooks-events/delete-webhook-endpoint.md): Referencia detallada para DELETE /v1/webhook_endpoints/{id}.
- [List webhook endpoints](https://docs.simplepay.mx/api-reference/endpoints/webhooks-events/list-webhook-endpoints.md): Referencia detallada para GET /v1/webhook_endpoints.
- [Replay an outbound event](https://docs.simplepay.mx/api-reference/endpoints/webhooks-events/replay-event.md): Referencia detallada para POST /v1/events/{id}/replay.
- [API Reference](https://docs.simplepay.mx/api-reference/overview.md): Mapa de la API publica de SimplePay, base URL, autenticacion, objetos principales, scopes y paginas por endpoint.
- [Disponibilidad](https://docs.simplepay.mx/bookable-payments/availability.md): Como modelar schedules, rules, overrides, blackouts y consultas de slots en Bookable Payments.
- [Checkout Bookable](https://docs.simplepay.mx/bookable-payments/checkout.md): Como convertir un slot en hold, checkout, booking pending y confirmacion final por pago en Bookable Payments.
- [Modelo Bookable](https://docs.simplepay.mx/bookable-payments/model.md): Mapa de objetos de Bookable Payments: productos, recursos, schedules, rules, overrides, blackouts, event types, holds y bookings.
- [Bookable Payments](https://docs.simplepay.mx/bookable-payments/overview.md): Bookable Payments combina inventario reservable, disponibilidad, holds, checkout hospedado, confirmacion por pago y lifecycle de reservas.
- [Bookable quickstart](https://docs.simplepay.mx/bookable-payments/quickstart.md): Crea una oferta reservable en una llamada, lista slots, crea un booking checkout y confirma la reserva por webhook.
- [Autenticacion](https://docs.simplepay.mx/essentials/authentication.md): Como autenticar llamadas a la API publica de SimplePay con bearer keys, scopes, tenant context y practicas seguras.
- [Ambientes y keys](https://docs.simplepay.mx/essentials/environments-and-keys.md): Diferencias entre sandbox y live, como preparar credenciales, como pensar en tenant environments y que validar antes de procesar dinero real.
- [Errores](https://docs.simplepay.mx/essentials/errors.md): Como interpretar respuestas de error en SimplePay, que hacer con 400, 401, 403, 404, 409, 422 y 5xx, y como instrumentar retries seguros.
- [Idempotencia](https://docs.simplepay.mx/essentials/idempotency.md): Como usar Idempotency-Key en SimplePay para reintentar writes sin duplicar checkouts, links, holds, bookings, recursos o refunds.
- [SimplePay Docs](https://docs.simplepay.mx/index.md): La puerta de entrada para integrar SimplePay: pagos hospedados, links, Bookable Payments, webhooks, referencia OpenAPI y contexto listo para LLMs.
- [Hosted Checkout](https://docs.simplepay.mx/payments/checkout-sessions.md): Integra Checkout Sessions de SimplePay para redirigir clientes a una pagina de pago hospedada y confirmar el resultado con webhooks.
- [Payment Links](https://docs.simplepay.mx/payments/payment-links.md): Crea links de pago reutilizables o limitados con SimplePay para invoices, cobros asincronos, ventas manuales y flujos no embebidos.
- [Refunds](https://docs.simplepay.mx/payments/refunds.md): Crea refunds en SimplePay usando referencias administradas por SimplePay, con idempotencia, politica de operacion y reconciliacion segura.
- [Quickstart](https://docs.simplepay.mx/quickstart.md): Crea tu primer pago en SimplePay con una sandbox key, una Checkout Session, redireccion segura y verificacion basica del estado.
- [Quickstart: Bookable Payments](https://docs.simplepay.mx/quickstarts/bookable-payments.md): Configura inventario reservado, consulta slots y crea un booking checkout con pago requerido.
- [Quickstart: Hosted Checkout](https://docs.simplepay.mx/quickstarts/hosted-checkout.md): Crea una Checkout Session, redirige al cliente y confirma el pago con webhook o API read.
- [Quickstart: Payment Links](https://docs.simplepay.mx/quickstarts/payment-links.md): Crea un link de pago reusable o de un solo uso para invoices, ventas manuales y cobros asincronos.
- [Quickstart: Webhooks](https://docs.simplepay.mx/quickstarts/webhooks.md): Configura un endpoint HTTPS, verifica SimplePay-Signature y procesa eventos de forma idempotente.
- [Eventos](https://docs.simplepay.mx/webhooks/events.md): Catalogo de eventos webhook recomendados para Bookable Payments, pagos, productos, customers y booking event types.
- [Pruebas locales](https://docs.simplepay.mx/webhooks/local-testing.md): Como probar webhooks de SimplePay en desarrollo con tunnels HTTPS, raw body, firma HMAC, replays y casos Bookable de sandbox.
- [Webhooks](https://docs.simplepay.mx/webhooks/overview.md): Configura endpoints webhook en SimplePay, verifica firmas HMAC, procesa eventos de forma idempotente y usa replays para recuperarte.

## OpenAPI Specs

- [openapi](https://docs.simplepay.mx/openapi.json)