Rejestruje webhook - adres URL po Twojej stronie, który Paymove wywołuje po zakończonej
płatności. Po rejestracji webhook musi zostać przypisany do produktu osobnym wywołaniem.
Liczba ponownych prób doręczenia. Pole jest wymagane, tak samo jak expectedCode - pominięcie któregokolwiek kończy się kodem 500. Wartość 0 oznacza brak ponowień.
Opcjonalny szablon body żądania (zmienne podstawiane przez Paymove).
Dla typu PAYMENT pominięcie pola, JSON null lub pusty obiekt {}
oznaczają pełny domyślny payload płatności. null musi być wartością
JSON, nie tekstem "null"; własny szablon musi być obiektem JSON,
nie tekstem zawierającym JSON.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Paymove Docs","colors":{"primary":"#4c6ff7","light":"#7d96ff","dark":"#1a1a1a"},"logo":{"light":"https://mintcdn.com/paymove/PpHxa3yf6uDsNUt4/logo/paymove-light.svg?fit=max\u0026auto=format\u0026n=PpHxa3yf6uDsNUt4\u0026q=85\u0026s=437bbda97025f27e0159c5fab9430847","dark":"https://mintcdn.com/paymove/PpHxa3yf6uDsNUt4/logo/paymove-dark.svg?fit=max\u0026auto=format\u0026n=PpHxa3yf6uDsNUt4\u0026q=85\u0026s=2e199e7de0f631677532b82f2e07439b"},"favicon":"https://mintcdn.com/paymove/TSMvwO93mxKXot0v/favicon.svg?fit=max\u0026auto=format\u0026n=TSMvwO93mxKXot0v\u0026q=85\u0026s=56f05f5663da48b496cd5ba34b306022","api":{"playground":{"display":"simple"},"mdx":{"auth":{"method":"key","name":"X-API-KEY"},"server":"https://gateway-api.sandbox.paymove.io"}},"appearance":{"default":"system"},"background":{"color":{"light":"#ffffff","dark":"#000000"}},"navbar":{"links":[{"icon":"play","href":"https://demo.checkout.paymove.io/","label":"Demo"}],"primary":{"type":"button","label":"Panel klienta","href":"https://panel.paymove.io"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/paymove"}},"search":{"prompt":"Szukaj lub zadaj pytanie..."},"seo":{"indexing":"all"},"fonts":{"family":"Google Sans Flex"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"one-dark-pro","dark":"one-dark-pro"}},"latex":false},"errors":{"404":{"redirect":false,"title":"Nie znaleźliśmy tej strony","description":"Adres mógł się zmienić. Spróbuj wyszukiwarki albo zacznij od jednej z popularnych stron."}},"contextual":{"options":["copy","view","claude","chatgpt","cursor","vscode","windsurf","download-spec",{"title":"Agent skill","description":"Wklej ten URL swojemu agentowi AI, aby wdrożył integrację","icon":"bot","href":"https://docs.paymove.io/skill.md"}],"display":"header"},"markdown":{"schema":true,"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\": \u003cint>, \"message\": \"\u003ctext>\"}`. 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. Registering a webhook requires both `retries` and `expectedCode` - omitting either returns HTTP 500, and `retries: 0` means no retry at all. 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. If the merchant has no `productId` yet, do not stop at a placeholder: ask for the API key, the `partnerId` and the shop name, propose defaults for `location` and `timezone` (`Europe/Warsaw`), offer the optional fields once, then create the product for them with `POST /api/product/pay` and take `productId` from `id` in the response. Do the same for the webhook: register it, then assign it to the product. Guided procedure: https://docs.paymove.io/skill.md (Steps 1-2).","15. 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"]},"navigation":{"languages":[{"language":"pl","default":true,"banner":{"content":"[Rozpocznij integrację z AI](/ai-agents)","dismissible":true,"color":{"light":"#4c6ff7","dark":"#101638"}},"href":"introduction"},{"language":"en","banner":{"content":"[Start integrating with AI](/en/ai-agents)","dismissible":true,"color":{"light":"#4c6ff7","dark":"#101638"}},"href":"en/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"paymove","hasAudioNarration":false,"actualSubdomain":"paymove","customDomains":["docs.paymove.io"],"gitSource":{"type":"gitlab","owner":"paymove/utils","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"projectId":79743263,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae3bd266b47d5c497b467c0","collectionId":"f0a5079e-c410-482d-a77f-40d85f555d28","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae3bd266b47d5c497b467c0"},"entitlements":{},"buildId":"6aed9dd16048afba019df1a2","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"Referencja API","count":33},{"language":"pl","tag":"Przewodniki","count":31},{"language":"en","tag":"Guides","count":28},{"language":"default","tag":"DocPay","count":26},{"language":"pl","tag":"Integracje","count":20},{"language":"en","tag":"Integrations","count":17},{"language":"pl","tag":"Integracja","count":11},{"language":"pl","tag":"Bramka płatnicza","count":9},{"language":"en","tag":"Payment Gateway","count":9},{"language":"en","tag":"Integration","count":9},{"language":"default","tag":"Formularze","count":8},{"language":"default","tag":"Bramka płatnicza","count":7},{"language":"default","tag":"Webhooki","count":7},{"language":"default","tag":"Personalizacja UI","count":5},{"language":"pl","tag":"Przycisk płatności (widget)","count":4},{"language":"pl","tag":"Tutoriale","count":4},{"language":"en","tag":"Payment button (widget)","count":4},{"language":"en","tag":"Tutorials","count":4},{"language":"default","tag":"Cennik","count":4},{"language":"pl","tag":"Wprowadzenie","count":3},{"language":"pl","tag":"AI Payments","count":3},{"language":"en","tag":"Introduction","count":3},{"language":"default","tag":"Płatności","count":3},{"language":"pl","tag":"Pomoc","count":2},{"language":"pl","tag":"Zasoby","count":2},{"language":"en","tag":"Help","count":2},{"language":"en","tag":"Resources","count":2},{"language":"en","tag":"DocPay","count":2},{"language":"default","tag":"Produkt","count":2},{"language":"default","tag":"Zwroty","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/paymove/9d551cf9009adf46/style.css"}],"page":{"pagePath":"api-reference/webhooki/zarejestruj-webhook","slug":"/api-reference/webhooki/zarejestruj-webhook","pageMetadata":{"title":"Zarejestruj webhook","description":"Rejestruje webhook - adres URL po Twojej stronie, który Paymove wywołuje po zakończonej\npłatności. Po rejestracji webhook musi zostać przypisany do produktu osobnym wywołaniem.\n","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/plugin/webhook","href":"/api-reference/webhooki/zarejestruj-webhook","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Rejestruje webhook - adres URL po Twojej stronie, który Paymove wywołuje po zakończonej\\npłatności. Po rejestracji webhook musi zostać przypisany do produktu osobnym wywołaniem.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"one-dark-pro","dark":"one-dark-pro"}},"config":{},"pageMetadata":{"title":"Zarejestruj webhook","description":"Rejestruje webhook - adres URL po Twojej stronie, który Paymove wywołuje po zakończonej\npłatności. Po rejestracji webhook musi zostać przypisany do produktu osobnym wywołaniem.\n","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/plugin/webhook","href":"/api-reference/webhooki/zarejestruj-webhook","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/paymove/14045507321b65c9/custom.js"],"openApiReferenceData":{"operation":{"operationId":"registerDocpayWebhook","summary":"Zarejestruj webhook","description":"Rejestruje webhook - adres URL po Twojej stronie, który Paymove wywołuje po zakończonej\npłatności. Po rejestracji webhook musi zostać przypisany do produktu osobnym wywołaniem.\n","tags":["Webhooki"],"requestBody":"4b9a3cfe-d77a-48c0-b2c0-c61067b8fda5","responses":{"200":"2118321d-442c-4d9b-a02c-aec99ef27f7c"},"method":"post","type":"path","servers":["4523ed34-dba7-4369-a857-b5fdc4b46a71"],"security":["c7c00bcd-ff24-4332-b543-a5bb96322ff5"],"path":"/api/pay/plugin/webhook","baseUrlOptions":["https://gateway-api.sandbox.paymove.io"],"title":"Zarejestruj webhook","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","endpoint","method","expectedCode","retries","partnerId","type"],"properties":{"name":{"type":"string","example":"PaymentSuccessHook","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"endpoint":{"type":"string","format":"uri","description":"URL, na który będą wysyłane powiadomienia","isRequired":true,"uniqueKey":"endpoint","typeLabel":"string\u003curi>"},"method":{"type":"string","enum":["POST"],"isRequired":true,"uniqueKey":"method","typeLabel":"enum\u003cstring>"},"expectedCode":{"type":"integer","example":200,"isRequired":true,"uniqueKey":"expectedCode","typeLabel":"integer"},"retries":{"type":"integer","description":"Liczba ponownych prób doręczenia. Pole jest wymagane, tak samo jak expectedCode - pominięcie któregokolwiek kończy się kodem 500. Wartość 0 oznacza brak ponowień.","example":3,"isRequired":true,"uniqueKey":"retries","typeLabel":"integer"},"partnerId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"partnerId","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["PAYMENT"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"requestTemplate":{"oneOf":[{"type":"object","description":"Opcjonalny szablon body żądania (zmienne podstawiane przez Paymove).\nDla typu PAYMENT pominięcie pola, JSON null lub pusty obiekt {}\noznaczają pełny domyślny payload płatności. null musi być wartością\nJSON, nie tekstem \"null\"; własny szablon musi być obiektem JSON,\nnie tekstem zawierającym JSON.\n","uniqueKey":"requestTemplate.oneOf.0","typeLabel":"object"},{"type":"null","description":"Opcjonalny szablon body żądania (zmienne podstawiane przez Paymove).\nDla typu PAYMENT pominięcie pola, JSON null lub pusty obiekt {}\noznaczają pełny domyślny payload płatności. null musi być wartością\nJSON, nie tekstem \"null\"; własny szablon musi być obiektem JSON,\nnie tekstem zawierającym JSON.\n","uniqueKey":"requestTemplate.oneOf.1","typeLabel":"null"}],"uniqueKey":"requestTemplate","typeLabel":"object | null"},"responseTemplate":{"type":"object","description":"Oczekiwana struktura odpowiedzi od partnera","uniqueKey":"responseTemplate","typeLabel":"object"},"expectedResponse":{"type":"string","example":"{ \"status\": \"ok\" }","uniqueKey":"expectedResponse","typeLabel":"string"},"headers":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"headers.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"headers.additionalProperties","typeLabel":"string[]"},"uniqueKey":"headers","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"name":"PaymentSuccessHook","endpoint":"https://example.com/webhooks/payment-success","method":"POST","requestTemplate":{"productId":"productId","event":"event"},"responseTemplate":{"status":"ok"},"expectedCode":200,"expectedResponse":"{ \"status\": \"ok\" }","retries":3,"partnerId":"78562c79-2f5c-4415-8af4-c871eea92ef2","type":"PAYMENT","headers":{"Authorization":["Bearer abc123"],"Content-Type":["application/json"]}},"examples":{"Example":{"title":"Example","value":{"name":"PaymentSuccessHook","endpoint":"https://example.com/webhooks/payment-success","method":"POST","requestTemplate":{"productId":"productId","event":"event"},"responseTemplate":{"status":"ok"},"expectedCode":200,"expectedResponse":"{ \"status\": \"ok\" }","retries":3,"partnerId":"78562c79-2f5c-4415-8af4-c871eea92ef2","type":"PAYMENT","headers":{"Authorization":["Bearer abc123"],"Content-Type":["application/json"]}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"2118321d-442c-4d9b-a02c-aec99ef27f7c":{"description":"Webhook zarejestrowany - odpowiedź zawiera `id` (webhookId) oraz `signingSecret`","content":{"application/json":{"schema":{"type":"object","description":"Obiekt webhooka zwracany przez API","properties":{"id":{"type":"string","format":"uuid","description":"Identyfikator webhooka (`webhookId`)","uniqueKey":"id","typeLabel":"string\u003cuuid>"},"name":{"type":"string","uniqueKey":"name","typeLabel":"string"},"endpoint":{"type":"string","format":"uri","uniqueKey":"endpoint","typeLabel":"string\u003curi>"},"method":{"type":"string","uniqueKey":"method","typeLabel":"string"},"requestTemplate":{"oneOf":[{"type":"object","uniqueKey":"requestTemplate.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"requestTemplate.oneOf.1","typeLabel":"null"}],"uniqueKey":"requestTemplate","typeLabel":"object | null"},"responseTemplate":{"type":"object","uniqueKey":"responseTemplate","typeLabel":"object"},"expectedCode":{"type":"integer","uniqueKey":"expectedCode","typeLabel":"integer"},"expectedResponse":{"type":"string","uniqueKey":"expectedResponse","typeLabel":"string"},"retries":{"type":"integer","uniqueKey":"retries","typeLabel":"integer"},"type":{"type":"string","uniqueKey":"type","typeLabel":"string"},"headers":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"headers.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"headers.additionalProperties","typeLabel":"string[]"},"uniqueKey":"headers","typeLabel":"object"},"signingSecret":{"type":"string","description":"Sekret do weryfikacji podpisu żądań przychodzących od Paymove - przechowuj bezpiecznie","uniqueKey":"signingSecret","typeLabel":"string"},"partnerId":{"type":"string","format":"uuid","uniqueKey":"partnerId","typeLabel":"string\u003cuuid>"},"productIds":{"type":"array","description":"Identyfikatory produktów, do których webhook jest przypisany","items":{"type":"string","format":"uuid","uniqueKey":"productIds.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"productIds","typeLabel":"string\u003cuuid>[]"},"retryOnCodes":{"type":"array","description":"Kody HTTP, które uruchamiają ponowienie","items":{"type":"integer","uniqueKey":"retryOnCodes.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"retryOnCodes","typeLabel":"integer[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"id":"18e19688-bdda-4843-8777-0f04d0143c77","name":"PaymentSuccessHook","endpoint":"https://example.com/webhooks/payment-success","method":"POST","requestTemplate":{"productId":"productId","event":"event"},"responseTemplate":{"status":"ok"},"expectedCode":200,"expectedResponse":"{ \"status\": \"ok\" }","retries":3,"type":"PAYMENT","headers":{"Authorization":["Bearer abc123"],"Content-Type":["application/json"]},"signingSecret":"whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},"examples":{"Example":{"title":"Example","value":{"id":"18e19688-bdda-4843-8777-0f04d0143c77","name":"PaymentSuccessHook","endpoint":"https://example.com/webhooks/payment-success","method":"POST","requestTemplate":{"productId":"productId","event":"event"},"responseTemplate":{"status":"ok"},"expectedCode":200,"expectedResponse":"{ \"status\": \"ok\" }","retries":3,"type":"PAYMENT","headers":{"Authorization":["Bearer abc123"],"Content-Type":["application/json"]},"signingSecret":"whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c7c00bcd-ff24-4332-b543-a5bb96322ff5":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"Klucz API dostarczony przez Paymove po zakończeniu procesu KYC.\nPrzykład: `sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`\n","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"4523ed34-dba7-4369-a857-b5fdc4b46a71":{"url":"https://gateway-api.sandbox.paymove.io","description":"Środowisko Sandbox (testowe)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"Klucz API dostarczony przez Paymove po zakończeniu procesu KYC.\nPrzykład: `sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`\n","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-KEY","type":"string","description":"Klucz API dostarczony przez Paymove po zakończeniu procesu KYC.\nPrzykład: `sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-KEY"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi-docpay.yaml"},"subdomain":"paymove","siteName":"Paymove Docs","title":"Zarejestruj webhook - Paymove Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pl":{"href":"/api-reference/webhooki/zarejestruj-webhook","matchLevel":0},"en":{"href":"/api-reference/webhooki/zarejestruj-webhook","matchLevel":0}}},"lastModified":"2026-10-29T20:25:15.458Z","originalFileLocation":"api-reference/webhooki/zarejestruj-webhook.mdx","locale":"pl"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Rejestruje webhook - adres URL po Twojej stronie, który Paymove wywołuje po zakończonej płatności. Po rejestracji webhook musi zostać przypisany do produktu osobnym wywołaniem.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Paymove Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/paymove/NUkdi2wV0O8khn02/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/paymove/NUkdi2wV0O8khn02/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/paymove/NUkdi2wV0O8khn02/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/paymove/NUkdi2wV0O8khn02/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/paymove/NUkdi2wV0O8khn02/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/paymove/NUkdi2wV0O8khn02/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/paymove/NUkdi2wV0O8khn02/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/paymove/NUkdi2wV0O8khn02/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/paymove/NUkdi2wV0O8khn02/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Zarejestruj webhook - Paymove Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Rejestruje webhook - adres URL po Twojej stronie, który Paymove wywołuje po zakończonej płatności. Po rejestracji webhook musi zostać przypisany do produktu osobnym wywołaniem.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Paymove Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.paymove.io/api-reference/webhooki/zarejestruj-webhook\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://paymove.mintlify.site/_mintlify/api/og/v2?division=Webhooki\u0026amp;title=Zarejestruj+webhook\u0026amp;description=Rejestruje+webhook+-+adres+URL+po+Twojej+stronie%2C+kt%C3%B3ry+Paymove+wywo%C5%82uje+po+zako%C5%84czonej%0Ap%C5%82atno%C5%9Bci.+Po+rejestracji+webhook+musi+zosta%C4%87+przypisany+do+produktu+oso\u0026amp;theme=5eef5e65f816b8d836123849\u0026amp;signature=be99204409f03677031668478a4edd4d568a830c8bc12edfa709d349303b1741\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Zarejestruj webhook - Paymove Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Rejestruje webhook - adres URL po Twojej stronie, który Paymove wywołuje po zakończonej płatności. Po rejestracji webhook musi zostać przypisany do produktu osobnym wywołaniem.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://paymove.mintlify.site/_mintlify/api/og/v2?division=Webhooki\u0026amp;title=Zarejestruj+webhook\u0026amp;description=Rejestruje+webhook+-+adres+URL+po+Twojej+stronie%2C+kt%C3%B3ry+Paymove+wywo%C5%82uje+po+zako%C5%84czonej%0Ap%C5%82atno%C5%9Bci.+Po+rejestracji+webhook+musi+zosta%C4%87+przypisany+do+produktu+oso\u0026amp;theme=5eef5e65f816b8d836123849\u0026amp;signature=be99204409f03677031668478a4edd4d568a830c8bc12edfa709d349303b1741\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/paymove/NUkdi2wV0O8khn02/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Paymove Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4c6ff7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.paymove.io/api-reference/webhooki/zarejestruj-webhook\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/webhooki/zarejestruj-webhook.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.paymove.io/#organization\",\"name\":\"Paymove Docs\",\"url\":\"https://docs.paymove.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/paymove/PpHxa3yf6uDsNUt4/logo/paymove-light.svg?fit=max\u0026auto=format\u0026n=PpHxa3yf6uDsNUt4\u0026q=85\u0026s=437bbda97025f27e0159c5fab9430847\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.paymove.io#website\",\"name\":\"Paymove Docs\",\"url\":\"https://docs.paymove.io\",\"publisher\":{\"@id\":\"https://docs.paymove.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.paymove.io/api-reference/webhooki/zarejestruj-webhook#webpage\",\"url\":\"https://docs.paymove.io/api-reference/webhooki/zarejestruj-webhook\",\"name\":\"Zarejestruj webhook\",\"description\":\"Rejestruje webhook - adres URL po Twojej stronie, który Paymove wywołuje po zakończonej płatności. Po rejestracji webhook musi zostać przypisany do produktu osobnym wywołaniem.\",\"dateModified\":\"2026-10-29T20:25:15.458Z\",\"isPartOf\":{\"@id\":\"https://docs.paymove.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.paymove.io/api-reference/webhooki/zarejestruj-webhook#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.paymove.io/api-reference/webhooki/zarejestruj-webhook#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Bramka płatnicza\",\"item\":\"https://docs.paymove.io/api-reference/p%C5%82atno%C5%9Bci/utw%C3%B3rz-p%C5%82atno%C5%9B%C4%87\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Zarejestruj webhook\",\"item\":\"https://docs.paymove.io/api-reference/webhooki/zarejestruj-webhook\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.paymove.io/api-reference/webhooki/zarejestruj-webhook#apireference\",\"headline\":\"Zarejestruj webhook\",\"name\":\"Zarejestruj webhook\",\"description\":\"Rejestruje webhook - adres URL po Twojej stronie, który Paymove wywołuje po zakończonej płatności. Po rejestracji webhook musi zostać przypisany do produktu osobnym wywołaniem.\",\"url\":\"https://docs.paymove.io/api-reference/webhooki/zarejestruj-webhook\",\"mainEntityOfPage\":{\"@id\":\"https://docs.paymove.io/api-reference/webhooki/zarejestruj-webhook#webpage\"},\"dateModified\":\"2026-10-29T20:25:15.458Z\",\"publisher\":{\"@id\":\"https://docs.paymove.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.paymove.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Paymove Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Paymove Docs","nav":{"global":null,"languages":[{"language":"pl","default":true,"banner":{"content":"[Rozpocznij integrację z AI](/ai-agents)","dismissible":true,"color":{"light":"#4c6ff7","dark":"#101638"}},"tabs":[{"tab":"Przewodniki","pages":[{"title":"Przewodniki","href":"/introduction"}]},{"tab":"Referencja API","groups":[{"group":"Bramka płatnicza","pages":[{"group":"Płatności","pages":[{"title":"Utwórz płatność","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/pay/product/{productId}/subproduct/pricing","href":"/api-reference/płatności/utwórz-płatność"},{"title":"Zmień kwotę płatności","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /api/pay/product/{productId}/subproduct/{externalId}","href":"/api-reference/płatności/zmień-kwotę-płatności"},{"title":"Sprawdź status płatności","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/payment/product/{productId}/subproduct/{paymentHash}/status","href":"/api-reference/płatności/sprawdź-status-płatności"}]},{"group":"Produkty","pages":[{"title":"Utwórz produkt (sklep)","description":"Tworzy produkt reprezentujący Twój sklep w systemie Paymove.\nWszystkie płatności są tworzone w ramach tego produktu. Produkt tworzysz jednorazowo, przy starcie integracji.\nPole `id` z odpowiedzi to `productId` używany w pozostałych wywołaniach.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/product/pay","href":"/api-reference/produkty/utwórz-produkt-sklep"}]},{"group":"Webhooki","pages":[{"title":"Zarejestruj webhook","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/plugin/webhook","href":"/api-reference/webhooki/zarejestruj-webhook"},{"title":"Przypisz webhook do produktu","description":"Powiązuje zarejestrowany webhook z produktem. Od tego momentu zdarzenia\n(np. udana płatność) dla tego produktu trafiają na wskazany `endpoint`.\n","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/plugin/webhook/{webhookId}/products/{productId}","href":"/api-reference/webhooki/przypisz-webhook-do-produktu"},{"title":"Lista produktów webhooka","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/plugin/webhook/{webhookId}/products","href":"/api-reference/webhooki/lista-produktów-webhooka"},{"title":"Wymień sekret podpisujący webhooka","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/pay/plugin/webhook/{webhookId}/rotate-secret","href":"/api-reference/webhooki/wymień-sekret-podpisujący-webhooka"}]},{"group":"Zwroty","pages":[{"title":"Pobierz zwroty płatności","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/pay/payment/{orderId}/refund","href":"/api-reference/zwroty/pobierz-zwroty-płatności"},{"title":"Zwróć płatność","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/pay/payment/{orderId}/refund","href":"/api-reference/zwroty/zwróć-płatność"}]}]},{"group":"DocPay","pages":[{"group":"Produkt","pages":[{"title":"Utwórz produkt","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/product/pay","href":"/api-reference/produkt/utwórz-produkt"},{"title":"Aktualizuj produkt","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml patch /api/product/pay/{productId}","href":"/api-reference/produkt/aktualizuj-produkt"}]},{"group":"Subprodukty i kody QR","pages":[{"title":"Zarejestruj subprodukt (kod QR)","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/product/{productId}/subproduct","href":"/api-reference/subprodukty-i-kody-qr/zarejestruj-subprodukt-kod-qr"}]},{"group":"Cennik","pages":[{"title":"Lista pozycji cennika","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/products/{productId}/pricing/entries","href":"/api-reference/cennik/lista-pozycji-cennika"},{"title":"Utwórz pozycję cennika","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/products/{productId}/pricing/entries","href":"/api-reference/cennik/utwórz-pozycję-cennika"},{"title":"Usuń pozycję cennika","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml delete /api/pay/products/{productId}/pricing/entries/{entryId}","href":"/api-reference/cennik/usuń-pozycję-cennika"},{"title":"Aktualizuj pozycję cennika","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml patch /api/pay/products/{productId}/pricing/entries/{entryId}","href":"/api-reference/cennik/aktualizuj-pozycję-cennika"}]},{"group":"Formularze","pages":[{"title":"Lista formularzy","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/product/{productId}/form","href":"/api-reference/formularze/lista-formularzy"},{"title":"Utwórz formularz","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/product/{productId}/form","href":"/api-reference/formularze/utwórz-formularz"},{"title":"Szczegóły formularza","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/product/{productId}/form/{formId}","href":"/api-reference/formularze/szczegóły-formularza"},{"title":"Usuń formularz","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml delete /api/pay/product/{productId}/form/{formId}","href":"/api-reference/formularze/usuń-formularz"},{"title":"Dodaj pole formularza","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/product/{productId}/form/{formId}/fields","href":"/api-reference/formularze/dodaj-pole-formularza"},{"title":"Usuń pole formularza","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml delete /api/pay/product/{productId}/form/{formId}/field/{fieldId}","href":"/api-reference/formularze/usuń-pole-formularza"},{"title":"Aktualizuj pole formularza","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml patch /api/pay/product/{productId}/form/{formId}/field/{fieldId}","href":"/api-reference/formularze/aktualizuj-pole-formularza"},{"title":"Szczegóły pola formularza","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/product/{productId}/form/field/{fieldId}","href":"/api-reference/formularze/szczegóły-pola-formularza"}]},{"group":"Personalizacja UI","pages":[{"title":"Lista customizacji","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/product/{productId}/customization","href":"/api-reference/personalizacja-ui/lista-customizacji"},{"title":"Utwórz customizację","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/product/{productId}/customization","href":"/api-reference/personalizacja-ui/utwórz-customizację"},{"title":"Szczegóły customizacji","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/product/{productId}/customization/{customizationId}","href":"/api-reference/personalizacja-ui/szczegóły-customizacji"},{"title":"Usuń customizację","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml delete /api/pay/product/{productId}/customization/{customizationId}","href":"/api-reference/personalizacja-ui/usuń-customizację"},{"title":"Aktualizuj customizację","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml patch /api/pay/product/{productId}/customization/{customizationId}","href":"/api-reference/personalizacja-ui/aktualizuj-customizację"}]},{"group":"Webhooki","pages":[{"title":"Lista webhooków","description":"Zwraca listę webhooków. Opcjonalnie filtrowana po `productId` lub `partnerId`.","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/plugin/webhook","href":"/api-reference/webhooki/lista-webhooków"},{"title":"Zarejestruj webhook","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/plugin/webhook","href":"/api-reference/webhooki/zarejestruj-webhook"},{"title":"Szczegóły webhooka","description":"Zwraca konfigurację webhooka.","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/plugin/webhook/{webhookId}","href":"/api-reference/webhooki/szczegóły-webhooka"},{"title":"Aktualizuj webhook","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml patch /api/pay/plugin/webhook/{webhookId}","href":"/api-reference/webhooki/aktualizuj-webhook"},{"title":"Lista produktów webhooka","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/plugin/webhook/{webhookId}/products","href":"/api-reference/webhooki/lista-produktów-webhooka"},{"title":"Przypisz webhook do produktu","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/plugin/webhook/{webhookId}/products/{productId}","href":"/api-reference/webhooki/przypisz-webhook-do-produktu"}]}]}]},{"tab":"Zmiany","pages":[{"title":"Zmiany","href":"/changelog"}]}]},{"language":"en","banner":{"content":"[Start integrating with AI](/en/ai-agents)","dismissible":true,"color":{"light":"#4c6ff7","dark":"#101638"}},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/en/introduction"}]},{"tab":"API Reference","groups":[{"group":"Payment Gateway","pages":[{"group":"Płatności","pages":[{"title":"Utwórz płatność","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/pay/product/{productId}/subproduct/pricing","href":"/api-reference/płatności/utwórz-płatność"},{"title":"Zmień kwotę płatności","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /api/pay/product/{productId}/subproduct/{externalId}","href":"/api-reference/płatności/zmień-kwotę-płatności"},{"title":"Sprawdź status płatności","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/payment/product/{productId}/subproduct/{paymentHash}/status","href":"/api-reference/płatności/sprawdź-status-płatności"}]},{"group":"Produkty","pages":[{"title":"Utwórz produkt (sklep)","description":"Tworzy produkt reprezentujący Twój sklep w systemie Paymove.\nWszystkie płatności są tworzone w ramach tego produktu. Produkt tworzysz jednorazowo, przy starcie integracji.\nPole `id` z odpowiedzi to `productId` używany w pozostałych wywołaniach.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/product/pay","href":"/api-reference/produkty/utwórz-produkt-sklep"}]},{"group":"Webhooki","pages":[{"title":"Zarejestruj webhook","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/plugin/webhook","href":"/api-reference/webhooki/zarejestruj-webhook"},{"title":"Przypisz webhook do produktu","description":"Powiązuje zarejestrowany webhook z produktem. Od tego momentu zdarzenia\n(np. udana płatność) dla tego produktu trafiają na wskazany `endpoint`.\n","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/plugin/webhook/{webhookId}/products/{productId}","href":"/api-reference/webhooki/przypisz-webhook-do-produktu"},{"title":"Lista produktów webhooka","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/plugin/webhook/{webhookId}/products","href":"/api-reference/webhooki/lista-produktów-webhooka"},{"title":"Wymień sekret podpisujący webhooka","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/pay/plugin/webhook/{webhookId}/rotate-secret","href":"/api-reference/webhooki/wymień-sekret-podpisujący-webhooka"}]},{"group":"Zwroty","pages":[{"title":"Pobierz zwroty płatności","deprecated":null,"version":null,"openapi":"/openapi.yaml get /api/pay/payment/{orderId}/refund","href":"/api-reference/zwroty/pobierz-zwroty-płatności"},{"title":"Zwróć płatność","deprecated":null,"version":null,"openapi":"/openapi.yaml post /api/pay/payment/{orderId}/refund","href":"/api-reference/zwroty/zwróć-płatność"}]}]},{"group":"DocPay","pages":[{"group":"Produkt","pages":[{"title":"Utwórz produkt","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/product/pay","href":"/api-reference/produkt/utwórz-produkt"},{"title":"Aktualizuj produkt","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml patch /api/product/pay/{productId}","href":"/api-reference/produkt/aktualizuj-produkt"}]},{"group":"Subprodukty i kody QR","pages":[{"title":"Zarejestruj subprodukt (kod QR)","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/product/{productId}/subproduct","href":"/api-reference/subprodukty-i-kody-qr/zarejestruj-subprodukt-kod-qr"}]},{"group":"Cennik","pages":[{"title":"Lista pozycji cennika","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/products/{productId}/pricing/entries","href":"/api-reference/cennik/lista-pozycji-cennika"},{"title":"Utwórz pozycję cennika","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/products/{productId}/pricing/entries","href":"/api-reference/cennik/utwórz-pozycję-cennika"},{"title":"Usuń pozycję cennika","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml delete /api/pay/products/{productId}/pricing/entries/{entryId}","href":"/api-reference/cennik/usuń-pozycję-cennika"},{"title":"Aktualizuj pozycję cennika","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml patch /api/pay/products/{productId}/pricing/entries/{entryId}","href":"/api-reference/cennik/aktualizuj-pozycję-cennika"}]},{"group":"Formularze","pages":[{"title":"Lista formularzy","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/product/{productId}/form","href":"/api-reference/formularze/lista-formularzy"},{"title":"Utwórz formularz","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/product/{productId}/form","href":"/api-reference/formularze/utwórz-formularz"},{"title":"Szczegóły formularza","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/product/{productId}/form/{formId}","href":"/api-reference/formularze/szczegóły-formularza"},{"title":"Usuń formularz","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml delete /api/pay/product/{productId}/form/{formId}","href":"/api-reference/formularze/usuń-formularz"},{"title":"Dodaj pole formularza","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/product/{productId}/form/{formId}/fields","href":"/api-reference/formularze/dodaj-pole-formularza"},{"title":"Usuń pole formularza","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml delete /api/pay/product/{productId}/form/{formId}/field/{fieldId}","href":"/api-reference/formularze/usuń-pole-formularza"},{"title":"Aktualizuj pole formularza","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml patch /api/pay/product/{productId}/form/{formId}/field/{fieldId}","href":"/api-reference/formularze/aktualizuj-pole-formularza"},{"title":"Szczegóły pola formularza","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/product/{productId}/form/field/{fieldId}","href":"/api-reference/formularze/szczegóły-pola-formularza"}]},{"group":"Personalizacja UI","pages":[{"title":"Lista customizacji","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/product/{productId}/customization","href":"/api-reference/personalizacja-ui/lista-customizacji"},{"title":"Utwórz customizację","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/product/{productId}/customization","href":"/api-reference/personalizacja-ui/utwórz-customizację"},{"title":"Szczegóły customizacji","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/product/{productId}/customization/{customizationId}","href":"/api-reference/personalizacja-ui/szczegóły-customizacji"},{"title":"Usuń customizację","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml delete /api/pay/product/{productId}/customization/{customizationId}","href":"/api-reference/personalizacja-ui/usuń-customizację"},{"title":"Aktualizuj customizację","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml patch /api/pay/product/{productId}/customization/{customizationId}","href":"/api-reference/personalizacja-ui/aktualizuj-customizację"}]},{"group":"Webhooki","pages":[{"title":"Lista webhooków","description":"Zwraca listę webhooków. Opcjonalnie filtrowana po `productId` lub `partnerId`.","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/plugin/webhook","href":"/api-reference/webhooki/lista-webhooków"},{"title":"Zarejestruj webhook","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/plugin/webhook","href":"/api-reference/webhooki/zarejestruj-webhook"},{"title":"Szczegóły webhooka","description":"Zwraca konfigurację webhooka.","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/plugin/webhook/{webhookId}","href":"/api-reference/webhooki/szczegóły-webhooka"},{"title":"Aktualizuj webhook","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml patch /api/pay/plugin/webhook/{webhookId}","href":"/api-reference/webhooki/aktualizuj-webhook"},{"title":"Lista produktów webhooka","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml get /api/pay/plugin/webhook/{webhookId}/products","href":"/api-reference/webhooki/lista-produktów-webhooka"},{"title":"Przypisz webhook do produktu","deprecated":null,"version":null,"openapi":"/openapi-docpay.yaml post /api/pay/plugin/webhook/{webhookId}/products/{productId}","href":"/api-reference/webhooki/przypisz-webhook-do-produktu"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/en/changelog"}]}]}]},"basePath":"","title":"Zarejestruj webhook - Paymove Docs","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-BcDCEkh6.js","dist-CwjSCXIK.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-eKJ4rcii.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","AssistantPageLink-9EK5IAXV.js"]}