Cost+Docs

Πληρωμές με Ένα Κλικ (CIT)

Ενεργοποίηση πληρωμών ενός κλικ που ξεκινούν από τον πελάτη με tokenization κάρτας

Οι πληρωμές με ένα κλικ επιτρέπουν στους επιστρέφοντες πελάτες να πληρώνουν με ένα μόνο κλικ χρησιμοποιώντας μια προηγουμένως αποθηκευμένη κάρτα. Αυτή είναι μια ροή Customer Initiated Transaction (CIT) που χρησιμοποιεί tokenization.

Πώς Λειτουργεί

Η ροή ενός κλικ έχει δύο φάσεις:

  1. Πρώτη πληρωμή — Ο πελάτης πληρώνει κανονικά και ζητάτε ένα token για μελλοντική χρήση
  2. Επόμενες πληρωμές — Χρησιμοποιήστε το αποθηκευμένο token για να χρεώσετε τον πελάτη με ένα κλικ

Φάση 1: Πρώτη Πληρωμή (Tokenization)

Δημιουργήστε μια παραγγελία με one_click_type: "first" στη συναλλαγή για να ζητήσετε tokenization:

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

Μετά από επιτυχή πληρωμή, η απόκριση θα περιλαμβάνει vault_token και first_transaction_id στο αντικείμενο συναλλαγής. Αποθηκεύστε αυτές τις τιμές — θα τις χρειαστείτε για μελλοντικές πληρωμές ενός κλικ.

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

Φάση 2: Πληρωμή με Ένα Κλικ

Χρησιμοποιήστε το αποθηκευμένο vault_token για να δημιουργήσετε μια πληρωμή ενός κλικ:

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

Μπορείτε να χρησιμοποιήσετε είτε vault_token είτε first_transaction_id για να αναφερθείτε στην αποθηκευμένη κάρτα. Και τα δύο λειτουργούν εναλλακτικά.

Διαχείριση CVC

Το CVC είναι προαιρετικό για πληρωμές ενός κλικ. Αν θέλετε να συλλέξετε CVC για πρόσθετη ασφάλεια, συμπεριλάβετέ το στη συναλλαγή:

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

Οι πληρωμές ενός κλικ ξεκινούν από τον πελάτη (CIT). Για επαναλαμβανόμενες χρεώσεις που ξεκινούν από τον έμπορο (MIT), δείτε Επαναλαμβανόμενες Πληρωμές.

Σχετικά Endpoints

On this page