ONhost Pay API
verze 1.0.0 · https://pay.onhost.cz/api/v1
Platební API ONhost Pay. Částky v haléřích (amount_minor). Zápisy vyžadují Idempotency-Key. Ostré platby jen po právním GO (pay.features.live_payments). Limit požadavků per API klíč podle tarifu (pay.features.api_key_rate_limits) vrací 429 s Retry-After.
SDK: Onhost\Sdk\Generated\PayClient (PHP), PayClient z @onhost/sdk (JS). Specifikace: openapi/sdk/pay.json.
| Metoda | Cesta | Popis |
|---|---|---|
| GET | /health/ready | Readiness probe (DB, outbox lag) |
| GET | /openapi.yaml | This specification (pay.features.api_docs) |
| POST | /checkout/sessions | Create a hosted checkout session |
| GET | /checkout/sessions/{id} | |
| GET | /payments/{id} | |
| POST | /payments/{id}/refunds | |
| POST | /subscriptions | |
| GET | /subscriptions/{id} | |
| POST | /subscriptions/{id}/cancel | |
| GET | /payment-links | List payment links (pay.features.payment_links) |
| POST | /payment-links | Create a shareable /p/{slug} link for a one-time product |
| GET | /payment-links/{id} | |
| POST | /payment-links/{id}/deactivate | |
| GET | /coupons | List promo codes (pay.features.coupons) |
| POST | /coupons | Create a percent or fixed (haléře) promo code |
| GET | /coupons/{id} | |
| POST | /coupons/{id}/deactivate | |
| POST | /webhooks/psp/{provider} | Inbound PSP webhook (signature verified, deduplicated) |
| GET | /onboarding/ares/{ico} | Prefill company data from ARES (session auth, pay.features.ares_lookup) |