Płatności jednym kliknięciem (CIT)

Włącz płatności jednym kliknięciem inicjowane przez klienta z tokenizacją kart

Płatności jednym kliknięciem pozwalają powracającym klientom płacić jednym kliknięciem przy użyciu wcześniej zapisanej karty. Jest to przepływ transakcji inicjowanych przez klienta (CIT) wykorzystujący tokenizację.

Jak to działa

Przepływ jednego kliknięcia składa się z dwóch faz:

Pierwsza płatność — Klient płaci normalnie, a Ty żądasz tokena do przyszłego użycia
Kolejne płatności — Użyj zapisanego tokena, aby obciążyć klienta jednym kliknięciem

Faza 1: Pierwsza płatność (tokenizacja)

Utwórz zamówienie z one_click_type: "first" w transakcji, aby zażądać tokenizacji:

POST /v1/orders/

{
  "merchant_order_id": "first-order",
  "currency": "EUR",
  "amount": 1295,
  "return_url": "https://www.example.com",
  "transactions": [
    {
      "payment_method": "credit-card",
      "one_click_type": "first"
    }
  ]
}

Po pomyślnej płatności odpowiedź będzie zawierać vault_token i first_transaction_id w obiekcie transakcji. Zapisz te wartości — będą potrzebne do przyszłych płatności jednym kliknięciem.

Odpowiedź (obiekt transakcji)

{
  "payment_method": "credit-card",
  "payment_method_details": {
    "vault_token": "abc123-stored-token",
    "first_authorised_transaction_id": "txn_def456"
  }
}

Faza 2: Płatność jednym kliknięciem

Użyj zapisanego vault_token, aby utworzyć płatność jednym kliknięciem:

POST /v1/orders/

{
  "merchant_order_id": "oneclick-order",
  "currency": "EUR",
  "amount": 995,
  "return_url": "https://www.example.com",
  "transactions": [
    {
      "payment_method": "credit-card",
      "one_click_type": "one-click",
      "vault_token": "{vault_token from phase 1}"
    }
  ]
}

Możesz użyć zarówno vault_token, jak i first_transaction_id, aby odwołać się do zapisanej karty. Oba działają zamiennie.

Obsługa CVC

CVC jest opcjonalne dla płatności jednym kliknięciem. Jeśli chcesz zebrać CVC dla dodatkowego bezpieczeństwa, dołącz go w transakcji:

{
  "payment_method": "credit-card",
  "one_click_type": "one-click",
  "vault_token": "{vault_token}",
  "cvc": "123"
}

Płatności jednym kliknięciem są inicjowane przez klienta (CIT). Dla cyklicznych obciążeń inicjowanych przez sprzedawcę (MIT) zobacz Płatności cykliczne.

Powiązane punkty końcowe

Utwórz zamówienie — użyj one_click_type w transakcji, aby zainicjować tokenizację lub płatności jednym kliknięciem