Κάρτες (Visa & Mastercard)

Αποδοχή πληρωμών με πιστωτικές και χρεωστικές κάρτες

Επισκόπηση

Αποδεχτείτε πληρωμές με πιστωτικές και χρεωστικές κάρτες μέσω του API της Cost+ χρησιμοποιώντας τη μέθοδο πληρωμής credit-card.

{
  "transactions": [
    {
      "payment_method": "credit-card"
    }
  ]
}

Υποστηριζόμενες Μάρκες Καρτών

Μάρκα	Τύπος
Amex	Πιστωτική
Mastercard	Πιστωτική / Χρεωστική
Maestro	Χρεωστική
Visa	Πιστωτική / Χρεωστική
V Pay	Χρεωστική

Επιλογές Ρύθμισης

Δυναμικός Περιγραφέας

Χρησιμοποιήστε το πεδίο dynamic_descriptor για να ορίσετε ένα προσαρμοσμένο κείμενο δήλωσης που εμφανίζεται στον τραπεζικό λογαριασμό ή στην κατάσταση κάρτας του πελάτη σας.

{
  "transactions": [
    {
      "payment_method": "credit-card",
      "payment_method_details": {
        "dynamic_descriptor": "My Store Order 123"
      }
    }
  ]
}

Χρήση Ονόματος Πελάτη ως Όνομα Κατόχου Κάρτας

Ορίστε use_customer_name_as_cardholder_name σε true για να χρησιμοποιηθεί αυτόματα το όνομα του πελάτη από την παραγγελία ως όνομα κατόχου κάρτας.

{
  "transactions": [
    {
      "payment_method": "credit-card",
      "payment_method_details": {
        "use_customer_name_as_cardholder_name": true
      }
    }
  ]
}

Προσαρμοσμένη Φόρμα Εισαγωγής Κάρτας

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

Βήμα 1: Δημιουργία Παραγγελίας με Setup Token

Δημιουργήστε μια παραγγελία και συμπεριλάβετε setup_token: true στο payment_method_details της συναλλαγής. Αυτό ενημερώνει την Cost+ να δημιουργήσει ένα setup token που μπορείτε να χρησιμοποιήσετε για ασφαλή tokenization στοιχείων κάρτας.

curl -X POST https://api.costplus.online/v1/orders \
  -u your-api-key: \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "EUR",
    "amount": 5000,
    "merchant_order_id": "order-001",
    "transactions": [
      {
        "payment_method": "credit-card",
        "payment_method_details": {
          "setup_token": true
        }
      }
    ],
    "return_url": "https://example.com/return",
    "webhook_url": "https://example.com/webhook"
  }'

Η απόκριση θα περιλαμβάνει μια τιμή setup_token στο payment_method_details της συναλλαγής:

{
  "id": "order-uuid",
  "transactions": [
    {
      "id": "txn-uuid",
      "payment_method": "credit-card",
      "payment_method_details": {
        "setup_token": "st_abc123..."
      }
    }
  ]
}

Βήμα 2: Tokenization Στοιχείων Κάρτας

Στείλτε τον αριθμό PAN κάρτας, την ημερομηνία λήξης και το setup token στο endpoint tokenization. Αυτό αποθηκεύει ασφαλώς την κάρτα και επιστρέφει ένα vault_token.

curl -X POST https://api.costplus.online/v1/tokens/ \
  -H "Content-Type: application/json" \
  -d '{
    "pan": "4111111111111111",
    "expiry_date": "1228",
    "setup_token": "st_abc123..."
  }'

Απόκριση:

{
  "vault_token": "vt_xyz789..."
}

Βήμα 3: Αυθεντικοποίηση Συναλλαγής

Υποβάλετε το vault_token και cvc στο endpoint αυθεντικοποίησης. Αν απαιτείται 3D Secure, θα λάβετε ένα redirect_url για να ανακατευθύνετε τον πελάτη στη σελίδα αυθεντικοποίησης της τράπεζάς του.

curl -X POST https://api.costplus.online/v1/orders/{order_id}/transactions/{transaction_id}/authenticate/ \
  -u your-api-key: \
  -H "Content-Type: application/json" \
  -d '{
    "vault_token": "vt_xyz789...",
    "cvc": "123"
  }'

Απόκριση:

{
  "redirect_url": "https://3ds.bank.example.com/auth?id=..."
}

Ανακατευθύνετε τον πελάτη στο redirect_url για να ολοκληρώσει την αυθεντικοποίηση 3D Secure. Μετά την ολοκλήρωση (ή ακύρωση) της αυθεντικοποίησης από τον πελάτη, θα ανακατευθυνθεί πίσω στο return_url σας.

Βήμα 4: Polling Κατάστασης Παραγγελίας

Μετά την επιστροφή του πελάτη από το 3D Secure, κάντε polling στην παραγγελία για να ελέγξετε την τελική κατάσταση.

curl -X GET https://api.costplus.online/v1/orders/{order_id} \
  -u your-api-key:

Η κατάσταση status της παραγγελίας θα μεταβεί σε μία από τις:

Κατάσταση	Σημασία
`completed`	Η πληρωμή ήταν επιτυχής
`cancelled`	Ο πελάτης ακύρωσε ή η αυθεντικοποίηση απέτυχε
`error`	Παρουσιάστηκε σφάλμα κατά την επεξεργασία
`expired`	Η παραγγελία έληξε πριν την ολοκλήρωση

Για ροές χειροκίνητης εξουσιοδότησης και δέσμευσης με πληρωμές κάρτας, δείτε τον οδηγό Εξουσιοδότηση / Δέσμευση / Ακύρωση.

On this page