Cost+Docs

Platby jedním kliknutím (CIT)

Povolte zákaznicky iniciované platby jedním kliknutím s tokenizací karet

Platby jedním kliknutím umožňují vracejícím se zákazníkům platit jedním kliknutím pomocí dříve uložené karty. Jedná se o tok Customer Initiated Transaction (CIT), který využívá tokenizaci.

Jak to funguje

Tok platby jedním kliknutím má dvě fáze:

  1. První platba — Zákazník platí běžným způsobem a vy požádáte o token pro budoucí použití
  2. Následné platby — Použijete uložený token k účtování zákazníkovi jedním kliknutím

Fáze 1: První platba (tokenizace)

Vytvořte objednávku s one_click_type: "first" v transakci pro vyžádání tokenizace:

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 úspěšné platbě odpověď bude obsahovat vault_token a first_transaction_id v objektu transakce. Uložte tyto hodnoty — budete je potřebovat pro budoucí platby jedním kliknutím.

Response (transaction object)
{
  "payment_method": "credit-card",
  "payment_method_details": {
    "vault_token": "abc123-stored-token",
    "first_authorised_transaction_id": "txn_def456"
  }
}

Fáze 2: Platba jedním kliknutím

Použijte uložený vault_token k vytvoření platby jedním kliknutím:

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}"
    }
  ]
}

K odkazování na uloženou kartu můžete použít buď vault_token, nebo first_transaction_id. Obě varianty fungují zaměnitelně.

Zpracování CVC

CVC je volitelné pro platby jedním kliknutím. Pokud chcete sbírat CVC pro dodatečné zabezpečení, zahrňte ho do transakce:

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

Platby jedním kliknutím jsou zákaznicky iniciované (CIT). Pro obchodníkem iniciované opakované platby (MIT) viz Opakované platby.

Související endpointy

  • Vytvoření objednávky — použijte one_click_type v transakci pro zahájení tokenizace nebo platby jedním kliknutím

On this page