Przejdź do głównej zawartości

Twisto

Twisto to dostawca płatności odroczonych, który pozwala klientowi kupić teraz i zapłacić w ciągu 30 dni bez dodatkowych kosztów, albo rozłożyć zakup na raty. Dla sklepu wygląda to jak każda inna płatność — rozliczenie z Paymentic jest standardowe, ryzyko niewypłacalności klienta przejmuje Twisto.

W Paymentic Twisto to jeden z dostawców pod metodą BNPL:

  • paymentMethod: BNPL
  • paymentChannel: twisto

Jak to działa?​

Krok 1. Utwórz transakcję​

Tworzysz transakcję z paymentMethod: "BNPL" i paymentChannel: "twisto". Im więcej danych klienta i zamówienia przekażesz w request, tym mniej informacji Twisto będzie musiało zbierać od klienta po drodze.

POST https://api.paymentic.com/v1_2/payment/points/{pointId}/transactions
{
  "amount": "249.00",
  "currency": "PLN",
  "title": "Zamówienie #67890",
  "paymentMethod": "BNPL",
  "paymentChannel": "twisto",
  "customer": {
    "name": "Anna Nowak",
    "email": "anna.nowak@example.com",
    "phone": "+48512345678",
    "ip": "83.12.45.210"
  },
  "billingAddress": {
    "firstName": "Anna",
    "lastName": "Nowak",
    "street": "ul. Długa",
    "buildingNumber": "12",
    "postalCode": "00-001",
    "city": "Warszawa",
    "country": "PL"
  },
  "order": {
    "id": "ORDER-67890",
    "shippingMethod": "TRACKED_DELIVERY",
    "customerType": "B2C"
  },
  "cart": [
    {
      "name": "Kurtka zimowa model Y",
      "quantity": 1,
      "unitPrice": "249.00",
      "type": "PRODUCT",
      "productType": "PHYSICAL"
    }
  ]
}

W odpowiedzi — standardowy obiekt z redirectUrl:

{
  "data": {
    "id": "WXYZ-789-ABC-4321",
    "redirectUrl": "https://pay.sandbox.paymentic.com/WXYZ-789-ABC-4321?token=...",
    "whitelabel": null
  }
}

Krok 2. Przekieruj klienta na redirectUrl​

Klient trafia na stronę Twisto z wnioskiem o odroczenie/rozłożenie płatności. Po zaakceptowaniu warunków wraca na Twój returnUrl.

Krok 3. Odbierz webhook z finalnym statusem​

Finalny status transakcji (PAID albo FAILED) przyjdzie webhookiem PAYMENT.TRANSACTION_STATUS_CHANGED. Tak jak w pozostałych metodach — to na jego podstawie decydujesz o realizacji zamówienia, a nie na podstawie samego powrotu z redirectUrl.

Szczegóły: PAYMENT.TRANSACTION_STATUS_CHANGED.

Ważne uwagi​

  • Decyzję podejmuje Twisto. Paymentic tylko przekazuje dane — ocena zdolności kredytowej i akceptacja wniosku są po stronie Twisto. Status FAILED może oznaczać, że wniosek został odrzucony, mimo poprawnego requestu.
  • Dane klienta warto przekazywać. Twisto potrzebuje m.in. telefonu i adresu rozliczeniowego — jeśli ich nie prześlesz, klient będzie musiał uzupełnić je na stronie Twisto, co obniża konwersję.
  • Limity kwot. Twisto ma minimalne i maksymalne kwoty transakcji. Sprawdzaj available w GET /v1_2/payment/points/{pointId}/channels dla danej kwoty, zanim pokażesz Twisto na ekranie wyboru — zob. Płatność z pominięciem bramki.
  • customerType: "B2C" dla osób prywatnych. Twisto obsługuje klientów indywidualnych — w order.customerType ustawiaj B2C.

Co dalej?​