Payment Integrations

Payment model

Ρόλοι συστήματος και παρόχου

Ο payment provider επεξεργάζεται τα ευαίσθητα στοιχεία πληρωμής. Το Nutrition Hub αποθηκεύει μόνο τα αναγκαία transaction και subscription references.

Provider

Στοιχεία κάρτας

Card number, CVV και authentication παραμένουν στο περιβάλλον του παρόχου.

Nutrition Hub

Transaction metadata

Amount, currency, status, transaction ID, customer και subscription IDs.

Webhook

Αξιόπιστη ενημέρωση

Signed server-to-server events ενημερώνουν payment και subscription status.

Billing

Invoices

Η οικονομική εγγραφή συνδέεται με το σωστό doctor account.

Configuration

Ρύθμιση βήμα-βήμα

Δημιουργήστε production account

Ολοκληρώστε KYC και ενεργοποιήστε τις απαιτούμενες μεθόδους.

Προσθέστε credentials

Αποθηκεύστε API keys/server secrets εκτός frontend και logs.

Ρυθμίστε webhook URL

Χρησιμοποιήστε HTTPS endpoint και σωστό signing secret.

Χαρτογραφήστε events

Payment success, failure, refund, subscription update και cancellation.

Δοκιμάστε idempotency

Το ίδιο webhook δεν πρέπει να δημιουργεί διπλή χρέωση ή invoice.

Webhook security

Υπογραφή και idempotency

Επαληθεύστε signature πριν διαβάσετε το payload.
Χρησιμοποιήστε raw request body όπου απαιτεί ο provider.
Αποθηκεύστε unique event ID και απορρίψτε duplicates.
Μην εμπιστεύεστε amount, currency ή account από client-side request.
Επιστρέψτε γρήγορα κατάλληλο HTTP status και επεξεργαστείτε βαριές εργασίες σε queue.

Fail closed

Αν η υπογραφή δεν επαληθεύεται, το event δεν πρέπει να αλλάζει billing ή license status.

Testing

Σενάρια που πρέπει να δοκιμαστούν

Σενάριο	Αναμενόμενο αποτέλεσμα
Successful payment	Paid status, invoice και σωστή ενεργοποίηση.
Failed payment	Failed/past-due χωρίς ψευδή ενεργοποίηση.
Duplicate webhook	Καμία δεύτερη οικονομική εγγραφή.
Refund	Refund status και λογιστική αναφορά.
Subscription cancellation	Σταματά η επόμενη ανανέωση.

FAQ

Συχνές ερωτήσεις

Πού αποθηκεύονται τα στοιχεία κάρτας;

Στον payment provider. Το Nutrition Hub δεν πρέπει να αποθηκεύει πλήρη card number ή CVV.

Γιατί η πληρωμή έγινε αλλά η άδεια δεν ενεργοποιήθηκε;

Ελέγξτε webhook delivery, signature, event mapping, idempotency και queue processing.