Cost+Docs

Yhden klikkauksen maksut (CIT)

Ota käyttöön asiakkaan aloittamat yhden klikkauksen maksut kortin tokenisoinnilla

Yhden klikkauksen maksut mahdollistavat palaavien asiakkaiden maksamisen yhdellä klikkauksella aiemmin tallennetulla kortilla. Tämä on asiakkaan aloittama tapahtuma (CIT) -kulku, joka käyttää tokenisointia.

Miten se toimii

Yhden klikkauksen kulku koostuu kahdesta vaiheesta:

  1. Ensimmäinen maksu — Asiakas maksaa normaalisti, ja sinä pyydät tokenin tulevaa käyttöä varten
  2. Seuraavat maksut — Käytä tallennettua tokenia veloittaaksesi asiakkaan yhdellä klikkauksella

Vaihe 1: Ensimmäinen maksu (tokenisointi)

Luo tilaus, jossa tapahtumassa on one_click_type: "first" tokenisointia varten:

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

Onnistuneen maksun jälkeen vastaus sisältää vault_token- ja first_transaction_id-arvot tapahtumaobjektissa. Tallenna nämä arvot — tarvitset niitä tuleviin yhden klikkauksen maksuihin.

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

Vaihe 2: Yhden klikkauksen maksu

Käytä tallennettua vault_token-arvoa yhden klikkauksen maksun luomiseen:

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

Voit käyttää joko vault_token- tai first_transaction_id-arvoa tallennetun kortin viittaamiseen. Molemmat toimivat vaihtokelpoisesti.

CVC:n käsittely

CVC on valinnainen yhden klikkauksen maksuissa. Jos haluat kerätä CVC:n lisäturvallisuutta varten, sisällytä se tapahtumaan:

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

Yhden klikkauksen maksut ovat asiakkaan aloittamia (CIT). Kauppiaan aloittamista toistuvista veloituksista (MIT) katso Toistuvat maksut.

Liittyvät päätepisteet

  • Luo tilaus — käytä one_click_type-kenttää tapahtumassa tokenisoinnin tai yhden klikkauksen maksujen käynnistämiseen

On this page