Przejdź do głównej zawartości

Płatności odroczone (BNPL)

Płatności odroczone (Buy-Now-Pay-Later) pozwalają klientowi otrzymać towar od razu, a zapłacić za niego później — w całości po określonym czasie albo w ratach. Z perspektywy sklepu wygląda to jak każda inna płatność: wysyłasz request o utworzenie transakcji, dostajesz redirectUrl, a po rozliczeniu — webhook ze statusem PAID.

W Paymentic wszyscy dostawcy BNPL są ukryci pod jedną wartością paymentMethod: "BNPL". Konkretny dostawca to paymentChannel.

Obsługiwani dostawcy

DostawcapaymentMethodpaymentChannelStrona
PayPoBNPLpaypoPayPo
TwistoBNPLtwistoTwisto
BLIK Płacę późniejBNPLblik-bnplBLIK Płacę później
wskazówka

Dokładną listę dostępnych kanałów zawsze pobieraj z endpointu GET /v1_2/payment/points/{pointId}/channels — zestaw może się zmieniać w zależności od umowy, waluty i kwoty transakcji. Szczegóły w Płatność z pominięciem bramki.

Dwa scenariusze integracji

Tak jak w przypadku innych metod, BNPL możesz zintegrować na dwa sposoby — różnica leży w tym, kto wybiera dostawcę:

  1. Klient wybiera na bramce Paymentic. Wysyłasz request bez paymentMethod/paymentChannel, a klient na ekranie wyboru klika np. PayPo. Możesz dodatkowo zawęzić listę widocznych metod przez filtrowanie metod płatności.
  2. Wybór dostawcy po Twojej stronie. Wysyłasz request z paymentMethod: "BNPL" oraz paymentChannel (np. paypo) i klient od razu trafia do wybranego dostawcy. Mechanizm jest ten sam co w płatności z pominięciem bramki.

Wspólne pola requestu

Wszyscy dostawcy BNPL korzystają z tego samego schematu CreateTransactionRequest. Pola, które warto przesłać przy płatnościach odroczonych:

PoleOpis
customerDane kontaktowe klienta (name, email, phone, ip, userAgent).
billingAddressAdres rozliczeniowy klienta (imię, nazwisko, ulica, kod pocztowy, miasto, kraj).
shippingAddressAdres dostawy. Może być identyczny z billingAddress albo inny.
orderMetadane zamówienia, m.in. shippingMethod, customerType (B2B/B2C), trackingNumber.
cartPozycje koszyka (name, quantity, unitPrice, productType).

Niektórzy dostawcy traktują te pola jako wymagane (zob. PayPo — direct redirect), a inni jako opcjonalne. Generalnie: im więcej danych przekażesz, tym mniejsza szansa, że dostawca poprosi klienta o ich uzupełnienie na swojej stronie.

Co dalej?