Cost+Docs

Ħlasijiet b'Klikk Waħda (CIT)

Attiva ħlasijiet b'klikk waħda inizjati mill-klijent b'tokenizzazzjoni tal-karta

Il-ħlasijiet b'klikk waħda jippermettu lill-klijenti li jerġgħu jiġu jħallsu b'klikk waħda bl-użu ta' karta maħżuna minn qabel. Dan huwa flusso ta' Customer Initiated Transaction (CIT) li juża tokenizzazzjoni.

Kif Taħdem

Il-flusso ta' klikk waħda għandu żewġ fażijiet:

  1. L-ewwel ħlas — Il-klijent iħallas normali, u int titlob token għall-użu futur
  2. Ħlasijiet sussegwenti — Uża t-token maħżun biex iċċarġja lill-klijent b'klikk waħda

Fażi 1: L-Ewwel Ħlas (Tokenizzazzjoni)

Oħloq ordni b'one_click_type: "first" fit-tranżazzjoni biex titlob tokenizzazzjoni:

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

Wara ħlas li rnexxielu, ir-risposta se tinkludi vault_token u first_transaction_id fl-oġġett tat-tranżazzjoni. Aħżen dawn il-valuri — se jkollok bżonnhom għal ħlasijiet futuri b'klikk waħda.

Risposta (oġġett tat-tranżazzjoni)
{
  "payment_method": "credit-card",
  "payment_method_details": {
    "vault_token": "abc123-stored-token",
    "first_authorised_transaction_id": "txn_def456"
  }
}

Fażi 2: Ħlas b'Klikk Waħda

Uża l-vault_token maħżun biex toħloq ħlas b'klikk waħda:

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

Tista' tuża jew vault_token jew first_transaction_id biex tirreferi għall-karta maħżuna. It-tnejn jaħdmu b'mod interkambjabbli.

Trattar tas-CVC

Is-CVC huwa opzjonali għal ħlasijiet b'klikk waħda. Jekk trid tiġbor is-CVC għal sigurtà addizzjonali, inkludih fit-tranżazzjoni:

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

Il-ħlasijiet b'klikk waħda huma inizjati mill-klijent (CIT). Għal ħlasijiet rikorrenti inizjati mill-kummerċjant (MIT), ara Ħlasijiet Rikorrenti.

Endpoints Relatati

  • Oħloq Ordni — uża one_click_type fit-tranżazzjoni biex tibda tokenizzazzjoni jew ħlasijiet b'klikk waħda

On this page