payment-integration

Integrate payments with SePay (VietQR), Polar, Stripe, Paddle (MoR subscriptions), Creem.io (licensing). Checkout, webhooks, subscriptions, QR codes, multi-provider orders.

1. Wybierz dostawcę płatności odpowiadający Twojemu rynkowi i modelowi biznesu: SePay dla rynku wietnamskiego i przelewów bankowych, Polar dla globalnych subskrypcji SaaS z automatycznymi benefitami (GitHub, Discord), Stripe dla płatności korporacyjnych i platform Connect, Paddle dla subskrypcji z globalnym podatkiem VAT, lub Creem.io dla licencjonowania oprogramowania i podziału przychodów.

2. Zapoznaj się z dokumentacją wybranego dostawcy dostępną w folderze references — przeczytaj overview.md, aby zrozumieć uwierzytelnianie i podstawowe koncepty, oraz api.md lub products.md w zależności od typu integracji (płatności jednorazowe, subskrypcje, licencje).

3. Skonfiguruj webhooks dla wybranego dostawcy, korzystając z pliku webhooks.md — ustaw adresy URL do odbierania powiadomień o transakcjach, zmianach subskrypcji i innych zdarzeniach, a następnie zweryfikuj integralność żądań zgodnie z dokumentacją.

4. Jeśli używasz Node.js, PHP lub Laravel, zainstaluj odpowiedni SDK opisany w sdk.md lub best-practices.md — dla SePay dostępne są SDK dla Node.js i PHP, dla Polar i innych dostawców znajdziesz wielojęzyczne biblioteki.

5. Zaimplementuj przepływ płatności dla Twojego przypadku użycia: dla płatności jednorazowych utwórz checkout, dla subskrypcji zarządzaj cyklem życia (próby, ulepszenia, anulowania), dla kodów QR (SePay) wygeneruj VietQR, a dla licencjonowania (Creem.io) obsługuj aktywację urządzeń i podział przychodów.

6. Przetestuj integrację w środowisku testowym dostawcy, weryfikując obsługę idempotencji w webhookach, poprawne przetwarzanie błędów oraz zgodność z wytycznymi produkcyjnymi zawartymi w best-practices.md dla wybranej platformy.