> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paymove.io/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> ## paymove integration rules for AI agents
>
> These rules are verified against the live API. Follow them exactly.
>
> 1. Amounts are INTEGERS in grosze (minor units). `1000` means 10.00 PLN. PLN is the only supported currency and there is no currency field in the API.
> 2. A float `price` (e.g. `12.99`) is SILENTLY TRUNCATED to 12 grosze and still returns HTTP 200. Always send an integer: `Math.round(pln * 100)`.
> 3. Authenticate with the `X-API-KEY` header. Never `Authorization: Bearer`. Sandbox keys start with `sk_test_`, production keys with `sk_live_`.
> 4. Server-side only. A call from a merchant page is rejected. Never put the key in frontend code.
> 5. Unknown request fields are silently ignored and still return HTTP 200 — a wrong body shape looks like success. Match the documented shape exactly.
> 6. A missing `externalId` returns HTTP 500 `Something went wrong`, not 400. A missing `price` or `details.returnUrl` returns HTTP 200 and a usable `redirectUrl` — no error at all. Validate the body yourself before sending it.
> 7. Always verify the `X-Paymove-Signature` header on incoming webhooks before trusting them: https://docs.paymove.io/en/webhook-signature.md
> 8. Errors are `{"status": <int>, "message": "<text>"}`. Branch on the HTTP status only — never on `message`, which is unstable and leaks internal class names.
> 9. There is no rate limiting, no HTTP 429, no HTTP 422, no `Idempotency-Key` header and no API versioning. Do not write code that handles them.
> 10. Re-POSTing an `externalId` that already exists returns HTTP 200 with the ORIGINAL `redirectUrl` and silently discards EVERY field you send — the new price, description and details are all ignored. Use `PATCH /api/pay/product/{productId}/subproduct/{externalId}` to change a price.
> 11. Webhooks fire only on `COMPLETED` by default, and `retries` defaults to `0` (no retries) unless you set it explicitly. Delivery counts as successful when the HTTP status equals `expectedCode` — the response body is never inspected.
> 12. Never fulfil an order on the `returnUrl` redirect. The checkout does not redirect there by itself: the customer has to click "back to shop", and inside the widget modal that redirect never happens. Fulfil only in the webhook handler, after verifying the signature.
> 13. Do not pin a version of `@paymove-io/sdk` — install the latest.
> 14. Full documentation index: https://docs.paymove.io/llms.txt · Copy-paste quickstart: https://docs.paymove.io/en/quickstart.md · Agent skill: https://docs.paymove.io/skill.md

# Metody płatności

> Obsługiwane metody płatności w Paymove

<CardGroup cols={2}>
  <Card title="BLIK" img="https://mintcdn.com/paymove/2FxkZI5pflzssOsK/images/blik.svg?fit=max&auto=format&n=2FxkZI5pflzssOsK&q=85&s=e872daf50a425235be5bd7c57365f489" href="https://blik.com" width="65" height="26" data-path="images/blik.svg">
    Natychmiastowe płatności kodem BLIK.
  </Card>

  <Card title="Apple Pay" img="https://mintcdn.com/paymove/2FxkZI5pflzssOsK/images/apple-pay.svg?fit=max&auto=format&n=2FxkZI5pflzssOsK&q=85&s=aee77f701ecef21d8e14edc67719cb45" href="https://www.apple.com/apple-pay/" width="65" height="26" data-path="images/apple-pay.svg">
    Płatności jednym kliknięciem na urządzeniach Apple.
  </Card>

  <Card title="Google Pay" img="https://mintcdn.com/paymove/2FxkZI5pflzssOsK/images/google-pay.svg?fit=max&auto=format&n=2FxkZI5pflzssOsK&q=85&s=9153d244f14c07331caf6a94aadfad21" href="https://pay.google.com" width="65" height="26" data-path="images/google-pay.svg">
    Szybkie płatności na Androidzie i w Chrome.
  </Card>

  <Card title="Płatność kartą" img="https://mintcdn.com/paymove/H-1HZZRGGZlAw6Q_/images/card.svg?fit=max&auto=format&n=H-1HZZRGGZlAw6Q_&q=85&s=04fc10ef065c86b9d4ff447017caed02" width="65" height="26" data-path="images/card.svg">
    Visa i Mastercard, płatność natychmiastowa.
  </Card>
</CardGroup>

Poza powyższymi checkout obsługuje też **Pay by Link** (przelew online przez stronę banku), **przelew tradycyjny** oraz **PayPo** (odroczona płatność). Dostępność poszczególnych metod zależy od konfiguracji Twojego produktu - jeśli którejś nie widzisz na checkoucie, napisz na [integration@paymove.io](mailto:integration@paymove.io).

<Info>
  **Wkrótce dostępne:** BLIK OneClick, Klarna, MCP
</Info>