Cost+Docs

Pagamenti con Un Clic (CIT)

Abilita i pagamenti con un clic iniziati dal cliente con tokenizzazione della carta

I pagamenti con un clic consentono ai clienti di ritorno di pagare con un singolo clic utilizzando una carta precedentemente memorizzata. Questo è un flusso Customer Initiated Transaction (CIT) che utilizza la tokenizzazione.

Come Funziona

Il flusso con un clic ha due fasi:

  1. Primo pagamento — Il cliente paga normalmente e tu richiedi un token per utilizzi futuri
  2. Pagamenti successivi — Usa il token memorizzato per addebitare il cliente con un clic

Fase 1: Primo Pagamento (Tokenizzazione)

Crea un ordine con one_click_type: "first" nella transazione per richiedere la tokenizzazione:

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

Dopo un pagamento riuscito, la risposta includerà un vault_token e un first_transaction_id nell'oggetto transazione. Salva questi valori — ti serviranno per i futuri pagamenti con un clic.

Risposta (oggetto transazione)
{
  "payment_method": "credit-card",
  "payment_method_details": {
    "vault_token": "abc123-stored-token",
    "first_authorised_transaction_id": "txn_def456"
  }
}

Fase 2: Pagamento con Un Clic

Usa il vault_token memorizzato per creare un pagamento con un clic:

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

Puoi usare sia vault_token che first_transaction_id per riferire la carta memorizzata. Entrambi funzionano in modo intercambiabile.

Gestione del CVC

Il CVC è opzionale per i pagamenti con un clic. Se vuoi raccogliere il CVC per una sicurezza aggiuntiva, includilo nella transazione:

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

I pagamenti con un clic sono iniziati dal cliente (CIT). Per gli addebiti ricorrenti iniziati dal commerciante (MIT), consulta Pagamenti Ricorrenti.

Endpoint Correlati

  • Crea Ordine — usa one_click_type nella transazione per avviare la tokenizzazione o i pagamenti con un clic

On this page