# Twisto - Płatności odroczone i "Podziel na 3"

Twisto to jedna z najpopularniejszych metod płatności odroczonych w Europie Środkowej. Pozwala Twoim klientom na błyskawiczne zakupy "na jedno kliknięcie" i uregulowanie należności w ciągu 30 dni. Dodatkowo oferuje atrakcyjny produkt **"Podziel na 3"**, który umożliwia rozłożenie kosztu koszyka na trzy równe, nieoprocentowane raty.

Dla Ciebie jako Partnera SimPay obie formy płatności Twisto są widoczne jako natychmiastowo opłacone, co pozwala na bezpieczną i szybką wysyłkę towaru do klienta.

## Limity kwotowe

W zależności od wybranego wariantu Twisto, obowiązują inne ramy kwotowe dla transakcji. Zadbaj o to, aby ukrywać odpowiednie metody płatności na ekranie zamówienia w Twoim sklepie, jeśli kwota koszyka nie spełnia tych wymagań.

Wymagania dla kwoty koszyka
* **Twisto (Odroczenie zapłaty o 30 dni):** od **1.00 PLN** do **2000.00 PLN**
* **Twisto "Podziel na 3" (Darmowe raty):** od **150.00 PLN** do **4500.00 PLN**


## 🚀 Jak zwiększyć szansę na akceptację transakcji?

Twisto podejmuje decyzję o przyznaniu odroczenia płatności lub rozłożenia na raty w ułamku sekundy, korzystając z zaawansowanych algorytmów analizy ryzyka. Jako programista masz realny wpływ na to, jak wielu Twoich klientów przejdzie tę weryfikację pomyślnie.

**Zdecydowanie zalecamy przesyłanie kompletu danych o kliencie:**

### 1. Obiekt `context` (Pełna historia klienta)

Przekazanie informacji o historii zakupowej klienta w Twoim sklepie drastycznie podnosi jego wiarygodność. W obiekcie `context` możesz przesłać wszystkie poniższe parametry:

* **`accountCreatedAt`** *(string)* – Data utworzenia konta kupującego w formacie ISO 8601.
* **`lastLoginAt`** *(string)* – Data ostatniego logowania kupującego na konto w sklepie (ISO 8601).
* **`hasPreviousPurchases`** *(boolean)* – Czy kupujący dokonywał wcześniej zakupu w sklepie?
* **`salesTotalCount`** *(integer)* – Ilość transakcji kupującego zrealizowanych przed tą transakcją.
* **`salesTotalAmount`** *(number)* – Łączna kwota wszystkich transakcji kupującego zrealizowanych przed tą transakcją.
* **`salesAvgAmount`** *(number)* – Średnia kwota transakcji kupującego zrealizowanych przed tą transakcją.
* **`salesMaxAmount`** *(number)* – Maksymalna kwota transakcji kupującego zrealizowanych przed tą transakcją.
* **`refundsTotalAmount`** *(number)* – Łączna kwota wszystkich zwrotów kupującego zrealizowanych przed tą transakcją.
* **`previousChargeback`** *(boolean)* – Czy kupujący miał wcześniej chargebacki.
* **`accountSetCurrency`** *(string)* – Ustawiona waluta konta kupującego (np. "PLN").


### 2. Dane `billing` oraz `shipping`

Przesłanie pełnych danych adresowych (imię, nazwisko, adres zamieszkania) jest kluczowe dla procesów antyfraudowych Twisto. Dzięki nim system może potwierdzić tożsamość klienta, co przekłada się na **wyraźnie wyższą szansę na uzyskanie kredytu/odroczenia**.

Nawet jeśli nie wymagasz adresu do dostawy (np. sprzedajesz produkty cyfrowe), przesłanie danych bilingowych (`billing`) pozwoli Twisto na sprawniejszą weryfikację.

## Integracja techniczna (directChannel)

Aby skierować klienta bezpośrednio do metod płatności Twisto, użyj jednego z poniższych parametrów w żądaniu `POST /payment/{serviceId}/transactions`:

* **`directChannel`:**
  * `twisto` – klasyczne odroczenie zapłaty o 30 dni.
  * `twisto-pay-in-3` – opcja rozłożenia płatności na 3 darmowe raty.
* **Obsługiwana waluta:** `PLN`


### Przykładowy Payload (Pełen Context + Billing)

Poniżej przykład żądania "idealnego", które dostarcza Twisto maksimum informacji niezbędnych do pozytywnej decyzji kredytowej:


```json
{
  "amount": 450.00,
  "currency": "PLN",
  "directChannel": "twisto-pay-in-3",
  "customer": {
    "email": "staly.klient@example.com",
    "ip": "5.6.7.8"
  },
  "billing": {
    "name": "Jan",
    "surname": "Kowalski",
    "street": "Wiejska",
    "building": "10",
    "city": "Warszawa",
    "postalCode": "00-001",
    "country": "PL"
  },
  "context": {
    "accountCreatedAt": "2023-01-15T10:00:00+01:00",
    "lastLoginAt": "2024-05-10T14:30:00+02:00",
    "hasPreviousPurchases": true,
    "salesTotalCount": 12,
    "salesTotalAmount": 2450.50,
    "salesAvgAmount": 204.20,
    "salesMaxAmount": 500.00,
    "refundsTotalAmount": 0.00,
    "previousChargeback": false,
    "accountSetCurrency": "PLN"
  },
  "antifraud": {
    "useragent": "Mozilla/5.0..."
  }
}
```

Wskazówka
Pamiętaj: brak danych adresowych lub kontekstowych nie zablokuje płatności, ale może zwiększyć odsetek transakcji odrzuconych przez Twisto. Przesyłanie tych informacji to najprostszy sposób na realne zwiększenie sprzedaży w Twoim sklepie.