Przejdź do treści
Oplac

Płatności subskrypcyjne dla SaaS, billing SaaS z BLIK, kartami i KSeF w jednym API

Oplac for SaaS to billing SaaS i płatności subskrypcyjne w jednej integracji: BLIK i karty, okresy próbne, zmiana planu z proracją, dunning z linkiem BLIK, faktury VAT wysyłane do KSeF oraz MRR i churn w panelu.

Czytaj dokumentację

Jedno API na BLIK, karty, subskrypcje z KSeF i odzyskiwanie płatności

Polski SaaS zwykle skleja billing z kilku miejsc: bramka od jednego operatora, własny kod do odnowień, osobny program do faktur, ręczne wysyłanie faktur do KSeF i arkusz z MRR. Każdy z tych kawałków ma własne błędy i własną integrację. W Oplac subskrypcja jest jednym obiektem, a wszystko, co z nią związane, dzieje się w tym samym miejscu.

  • Subskrypcje i plany: okres miesięczny albo roczny, kilka cen jednego planu, waluta PLN, EUR albo USD w walucie obsługiwanej przez dostawcę.
  • Okresy próbne: trial z kartą albo bez, z przypomnieniem przed pierwszym obciążeniem.
  • Proracja: upgrade i downgrade w połowie okresu, z dopłatą albo pomniejszeniem kolejnej faktury, liczone co do dnia.
  • Kupony: rabat procentowy albo kwotowy, na jeden okres albo na stałe.
  • Faktury cykliczne: faktura VAT po każdym opłaconym okresie, z wysyłką do KSeF.
  • Dunning: ponowienia, e-mail i link BLIK do dopłaty w module Recover.
  • Analityka: MRR, churn i przychód z odnowień w panelu.

Dlaczego sama bramka nie wystarcza jako płatności dla SaaS

Zespół SaaS, który zaczyna od samej bramki, szybko dopisuje własny billing: tabelę subskrypcji, zadania odnowień, obsługę zmian planów, generowanie faktur, wysyłkę do KSeF i maile o nieudanych płatnościach. Każdy z tych kawałków trzeba utrzymywać, a błąd w jednym oznacza klienta bez dostępu albo fakturę bez płatności.

Sama bramka

Co piszesz sam
subskrypcje, odnowienia, proracje, faktury, KSeF, dunning
Co dostajesz gotowe
przyjęcie jednorazowej płatności

Bramka plus osobny billing

Co piszesz sam
synchronizację dwóch systemów i faktury z KSeF
Co dostajesz gotowe
płatności i część subskrypcji

Oplac

Co piszesz sam
tylko logikę dostępu w swojej aplikacji
Co dostajesz gotowe
płatności, subskrypcje, faktury z KSeF, dunning, MRR

Jak wdrażasz billing SaaS w Oplac, krok po kroku

  1. 01Zakładasz konto, dostajesz klucz testowy i tworzysz plany w panelu albo przez API.
  2. 02Podpinasz licencjonowanego dostawcę płatności, z którym Twoja firma ma umowę.
  3. 03Przy rejestracji klienta tworzysz subskrypcję. Klient płaci pierwszy raz na stronie płatności, a dostawca zapisuje token karty.
  4. 04Nasłuchujesz webhooków: subscription.created, invoice.paid, invoice.payment_failed, subscription.canceled. Każdy ma podpis HMAC i jest ponawiany do skutku.
  5. 05Włączasz faktury VAT i integrację KSeF w module Bill.
  6. 06Ustawiasz harmonogram dunningu w module Recover i przełączasz klucz na produkcyjny.

Pełną listę zdarzeń i obiektów znajdziesz w dokumentacji API. Webhookom i idempotencji poświęciliśmy wpis webhooki płatności.

PHP 
$oplac->subscriptions->update('sub_test_8812', [
    'plan' => 'plan_pro_miesieczny',
    'proration' => 'create_invoice',
], ['idempotency_key' => 'upgrade-8812-pro']);

Proracja, okresy próbne i zmiana planu bez ręcznych korekt

Proracja to rozliczenie zmiany planu w trakcie okresu. Gdy klient przechodzi z planu za 200 zł na plan za 500 zł w połowie miesiąca, płaci różnicę za pozostałe dni, a przy kolejnym odnowieniu już pełną nową cenę. Przy przejściu w dół niewykorzystana część pomniejsza następną fakturę. Oplac liczy to sam i wystawia fakturę albo korektę zgodnie z ustawieniem, a w symulatorze na stronie głównej sprawdzasz wynik na własnych kwotach. Okres próbny kończy się pierwszym obciążeniem albo wygaśnięciem subskrypcji, jeśli klient nie podał karty.

Faktury cykliczne i KSeF po każdym odnowieniu

Każde opłacone odnowienie to faktura VAT. Bill wystawia ją z danymi nabywcy zapisanymi przy subskrypcji, numeruje w Twojej serii i wysyła do KSeF, a numer KSeF wraca do panelu i do webhooka. Klient dostaje fakturę mailem, a dział finansów widzi status wysyłki przy każdym dokumencie. Szczegóły przepływu opisujemy na stronie integracja KSeF z płatnościami i we wpisie KSeF a płatności online.

Dunning z linkiem BLIK i MRR, który widać w panelu

Nieudane odnowienie w SaaS to przychód, który znika po cichu, jeśli nikt się o niego nie upomni. Recover ponawia obciążenie, wysyła e-mail, potem link BLIK do dopłaty, a na końcu prośbę o zmianę karty. Panel pokazuje MRR, churn i odnowienia w trakcie odzyskiwania, więc widzisz, ile przychodu wisi na nieudanych płatnościach. Mechanizm rozpisujemy na stronie odzyskiwanie nieudanych płatności, a podstawy odnowień na stronie płatności cykliczne.

Co dostaje programista, a co dział finansów

Programista dostaje REST API, webhooki z podpisem HMAC i ponowieniami, klucze idempotencji, piaskownicę oraz przykłady w curl, PHP, Node i Pythonie. Finanse dostają panel z MRR, churnem, przychodem według planów, uzgadnianiem wpłat i eksportem do księgowości. Rozliczenie w PLN, EUR i USD odbywa się w walutach obsługiwanych przez dostawcę płatności. Zacznij od dokumentacji API.

Platforma subskrypcyjna w planach Oplac

Firma

Cena netto
299 zł/mies. (1 788 zł/rok)
Co masz dla SaaS
Bill (subskrypcje, trial, proracje, kupony, faktury VAT, KSeF), Recover e-mail, Invoices, obrót do 250 000 zł

Skala

Cena netto
999 zł/mies. (5 988 zł/rok)
Co masz dla SaaS
Firma plus pełny Recover (link BLIK do dopłaty, zmiana karty), MRR i churn, PLN, EUR i USD, Smart routing do trzech dostawców, obrót do 1 500 000 zł

Platforma

Cena netto
2 999 zł/mies. (17 988 zł/rok)
Co masz dla SaaS
Skala plus routing bez limitu dostawców, role, SSO SAML, log audytu, SLA 99,9 procent, opiekun wdrożenia, obrót do 10 000 000 zł

Enterprise

Cena netto
na wycenę
Co masz dla SaaS
indywidualne limity, SLA i umowa powierzenia, obrót powyżej 10 000 000 zł

Plan Start za 199 zł miesięcznie (1 188 zł rocznie) obejmuje płatności jednorazowe bez modułu Bill. Opłaty transakcyjne pobiera dostawca płatności według swojego cennika.

Zobacz cennik

Najczęstsze pytania

Wszystkie pytania

Czy Oplac zastępuje własny kod do subskrypcji?

Tak. Harmonogram odnowień, proracje, trial, kupony, faktury i ponowienia prowadzi moduł Bill, a Twoja aplikacja reaguje na webhooki i nadaje albo odbiera dostęp.

Czy faktury z subskrypcji trafiają do KSeF automatycznie?

Tak, po włączeniu integracji KSeF w module Bill. Faktura powstaje po opłaceniu okresu i jest wysyłana do KSeF, a numer KSeF wraca do panelu.

Czy klienci mogą płacić za subskrypcję BLIK?

Tak, w zakresie obsługiwanym przez dostawcę. Tam, gdzie dostawca obsługuje płatności cykliczne BLIK albo zapisany alias, odnowienie idzie automatycznie. W pozostałych przypadkach klient dostaje link BLIK do opłacenia okresu.

Jak przetestować proracje i dunning przed wdrożeniem?

W piaskownicy tworzysz subskrypcję, zmieniasz plan w połowie okresu i symulujesz nieudane odnowienie. Webhooki testowe przychodzą tak samo jak na produkcji.

Czy mogę przenieść istniejące subskrypcje do Oplac?

Tak, subskrypcje importujesz przez API z datą następnego odnowienia. Tokeny kart przenosi się między dostawcami tylko wtedy, gdy obaj dostawcy to obsługują, a w pozostałych przypadkach klient przy odnowieniu dostaje link do ponownego podania metody.

Jak Oplac nalicza proracje przy zmianie planu?

Przy upgrade Oplac nalicza różnicę za dni pozostałe do końca okresu i pobiera ją od razu albo przy odnowieniu, zależnie od ustawienia. Przy downgrade niższa cena obowiązuje od następnego okresu, a nadpłata za bieżący okres pomniejsza kolejną fakturę.

Czy moja aplikacja musi odpytywać Oplac o stan subskrypcji?

Nie, Oplac wysyła webhooki o każdej zmianie: odnowieniu, nieudanej płatności, zmianie planu i anulowaniu. Odpytywanie API jest potrzebne tylko do uzgodnienia stanu po awarii.

Powiązane strony

Przenieś billing SaaS do jednego API

Załóż konto i przetestuj w piaskownicy subskrypcję z trialem, zmianą planu i nieudanym odnowieniem.

Czytaj dokumentację

BLIK, karty, subskrypcje i KSeF w jednym panelu.