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:
- Primo pagamento — Il cliente paga normalmente e tu richiedi un token per utilizzi futuri
- 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:
{
"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.
{
"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:
{
"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_typenella transazione per avviare la tokenizzazione o i pagamenti con un clic