Πώληση φυσικών αγαθών: ροές πληρωμών
Σε αυτήν τη σελίδα
Μάθημα ξαναγράφηκε στις 3 Νοεμβρίου 2026 με βάση την αναφορά API Checkout, τη σελίδα Προσθήκη UI στον διακομιστή MCP σας και τις οδηγίες Plugin της OpenAI. Η προηγούμενη έκδοση κάλυπτε την πώληση συνδρομών και ψηφιακών προϊόντων χρησιμοποιώντας επινοημένες συναρτήσεις (
defineProduct,commerceFlow) και μια δομή προμήθειας 30%/15% χωρίς πηγές. Οι τρέχοντες κανόνες των plugin περιορίζουν το εμπόριο αποκλειστικά σε φυσικά αγαθά, ενώ η τεκμηρίωση δεν αναφέρει προμήθειες. Πηγές: Αναφορά API Checkout · Οδηγίες Plugin.
Τι μπορείτε να πουλήσετε
Ξεκινήστε με τον κανόνα, καθώς αυτός διέπει τα πάντα. Οι κανόνες δημοσίευσης της OpenAI είναι σαφείς: ένα plugin μπορεί να διεξάγει εμπόριο μόνο για φυσικά αγαθά. Απαγορεύεται η πώληση ψηφιακών προϊόντων ή υπηρεσιών—συνδρομές, ψηφιακό περιεχόμενο, tokens, πιστώσεις—είτε άμεσα είτε έμμεσα (για παράδειγμα, μέσω αναβάθμισης freemium). Ισχύει επίσης μια λίστα απαγορευμένων αγαθών και υπηρεσιών (περιεχόμενο για ενήλικες, τζόγος, φάρμακα με συνταγή, όπλα, καπνός και νικοτίνη, πειρατικό λογισμικό, παραπλανητικές οικονομικές υπηρεσίες, μεταξύ άλλων). Το Μάθημα 13 επανεξετάζει τι μπορεί ακόμη να κάνει μια υπηρεσία συνδρομής εντός αυτών των ορίων.
Σε αυτό το πλαίσιο, η OpenAI τεκμηριώνει τρεις ροές πληρωμών.
Ροή 1: Εξωτερική πληρωμή, η προεπιλεγμένη διαδρομή
Η εξωτερική πληρωμή είναι η συνιστώμενη προσέγγιση και είναι διαθέσιμη σε όλους. Το UI του plugin παρουσιάζει eligible προϊόντα, για παράδειγμα με ένα κουμπί “Αγορά”. Όταν ο χρήστης αποφασίσει να αγοράσει, η διεπαφή τον ανακατευθύνει σε μια σήραγγα checkout που φιλοξενείται στο δικό σας domain. Οι τιμές, η είσπραξη, οι φόροι, οι εκπτώσεις, η αποστολή, οι επιστροφές χρημάτων, η υποστήριξη και η συμμόρφωση παραμένουν αποκλειστικά δική σας ευθύνη. Μετά την αγορά, ο χρήστης μπορεί να επιστρέψει στο ChatGPT με την επιβεβαίωση παραγγελίας ή την παρακολούθηση παράδοσής του.
Για να ανοίξει αυτόν τον σύνδεσμο, το ChatGPT παρέχει την επέκταση window.openai.openExternal({ href }), η οποία ανοίγει έναν ελεγχόμενο σύνδεσμο στον περιηγητή του χρήστη. Πρέπει να δηλώσετε τους επιτρεπτούς προορισμούς ανακατεύθυνσης στο _meta["openai/widgetCSP"].redirect_domains: η τυπική πολιτική _meta.ui.csp δεν καλύπτει αυτή την περίπτωση. Για έναν εγκεκριμένο προορισμό, το ChatGPT προσθέτει μια παράμετρο ?redirectUrl=… στη διεύθυνση από προεπιλογή· η ρύθμιση redirectUrl: false το αποτρέπει.
function openPayment(cartUrl) {
if (window.openai?.openExternal) {
window.openai.openExternal({ href: cartUrl });
} else {
// Ο host στερείται αυτής της επέκτασης: αφήστε τον χρήστη να αντιγράψει τον σύνδεσμο
document.querySelector("#payment-link").textContent = cartUrl;
}
}
Οι κανόνες είναι συγκεκριμένοι: εφόσον η ενσωματωμένη πληρωμή δεν είναι ανοιχτή για το plugin σας, η εξωτερική πληρωμή είναι η υποχρεωτική διαδρομή. Καμία άλλη λύση πληρωμής τρίτου μέρους δεν μπορεί να ενσωματωθεί ή να φιλοξενηθεί μέσα στο UI του plugin.
Ροή 2: Προηγουμένως αποθηκευμένες μέθοδοι πληρωμής
Για eligible αγορές φυσικών αγαθών, το UI μπορεί να προσφέρει στον πελάτη μια μέθοδο πληρωμής που έχει ήδη αποθηκεύσει σε εσάς. Ο χρήστης επιλέγει αυτή τη μέθοδο και επιβεβαιώνει την αγορά μέσα στο ChatGPT, χωρίς να εγκαταλείψει τη συνομιλία. Ο διακομιστής MCP σας επεξεργάζεται την παραγγελία και επιστρέφει τη δεσμευτική επιβεβαίωση. Αυτή η ροή μπορεί να εμφανίζει αποθηκευμένες μεθόδους πληρωμής, αλλά δεν μπορεί να συλλέγει νέα στοιχεία πληρωμής.
Ροή 3: Το φύλλο checkout του ChatGPT (ιδιωτική beta)
Για να συλλέξετε μια νέα μέθοδο πληρωμής μέσα στη ροή, χρειάζεστε το φύλλο checkout του ChatGPT. Αυτή η ενσωματωμένη λειτουργία πληρωμής βρίσκεται σε ιδιωτική beta, είναιreserved για συγκεκριμένες αγορές και δεν είναι προσβάσιμη σε όλους τους προγραμματιστές ή χρήστες. Η λειτουργία της αξίζει να κατανοηθεί επειδή απεικονίζει τον διαχωρισμό των ρόλων μεταξύ του host και του διακομιστή σας:
- Ένα εργαλείο MCP επιστρέφει μια συνεδρία πληρωμής στο
structuredContent. - Το στοιχείο εμφανίζει αντικείμενα, σύνολα, όρους και επιλογές αποστολής.
- Όταν ο χρήστης επιλέγει να πληρώσει, το στοιχείο καλεί το
window.openai.requestCheckout(session)· το ChatGPT ανοίγει το φύλλο checkout του. - Μετά την επικύρωση, το ChatGPT στέλνει ένα token που αντιπροσωπεύει την επιλεγμένη μέθοδο πληρωμής στο εργαλείο
complete_checkoutτου διακομιστή σας. Αυτό το εργαλείο χρεώνει μέσω του παρόχου πληρωμών σας και επιστρέφει την οριστικοποιημένη παραγγελία—το αποτέλεσμα που λαμβάνει το στοιχείο ως απάντηση στοrequestCheckout.
Η συνεδρία πρέπει να περιέχει ένα μοναδικό αναγνωριστικό, αντικείμενα και τις ποσότητές τους, σύνολα σε μικρές μονάδες νομίσματος (λεπτά, όχι δεκαδικά ευρώ), πάροχο πληρωμών και μεταδεδομένα εμπόρου, καθώς και υποχρεωτικούς συνδέσμους: όρους, απόρρητο, επιστροφές χρημάτων και υποστήριξη. Το ChatGPT προσθέτει τα δικά του πεδία, όπως merchant ή conversation_id.
Ο διακομιστής είναι η πηγή της αλήθειας
Ανεξάρτητα από τη ροή, ισχύει η ίδια πειθαρχία:
- Οι τιμές και η κατάσταση της παραγγελίας προέρχονται από τον διακομιστή, ποτέ από ένα σύνολο που υπολογίζεται στο στοιχείο.
- Το token πληρωμής επαληθεύεται, η λειτουργία είναι ιδιόμορφη (idempotent)—ένα διπλό κλικ δεν πρέπει να χρεώσει δύο φορές—η παραγγελία καταγράφεται και επιστρέφεται μια απόδειξη αναφοράς.
- Η ακύρωση, η άρνηση πληρωμής και τα σφάλματα του παρόχου διαχειρίζονται στο στοιχείο. Για το φύλλο checkout, τα σφάλματα
payment_declinedκαιrequires_3dsπου επιστρέφονται από τοcomplete_checkoutεμφανίζονται απευθείας στο φύλλο του ChatGPT.
Για το φύλλο checkout, το payment_mode: "test" σας επιτρέπει να δοκιμάσετε τη ροή από άκρο σε άκρο με κάρτες δοκιμής χωρίς να μετακινηθούν πραγματικά κεφάλαια.
Διατηρήστε χρήσιμα εργαλεία διαθέσιμα χωρίς UI
Όπως και με το υπόλοιπο plugin, ο κατάλογος και οι δυνατότητες παραγγελίας πρέπει να παραμένουν προσβάσιμες μέσω εργαλείων που μπορούν να χρησιμοποιηθούν χωρίς στοιχείο. Το UI χρησιμεύει για την παρουσίαση προϊόντων, τιμών, όρων και επιλογών πληρωμής πριν την επιβεβαίωση. Δεν αντικαθιστά robust εργαλεία δεδομένων και ποτέ δεν αποφασίζει για μια τιμή.
Βασικά σημεία
- Ένα plugin πουλά μόνο φυσικά αγαθά: οι συνδρομές, το ψηφιακό περιεχόμενο, οι πιστώσεις και οι αναβαθμίσεις freemium απαγορεύονται
- Η εξωτερική πληρωμή στο domain σας είναι η συνιστώμενη διαδρομή διαθέσιμη σε όλους· το
openExternalανοίγει τον σύνδεσμο - Οι αποθηκευμένες μέθοδοι πληρωμής μπορούν να προσφερθούν, όχι να συλλεχθούν
- Το φύλλο checkout του ChatGPT (
requestCheckout+complete_checkout) βρίσκεται σε ιδιωτική beta,reserved για συγκεκριμένες αγορές - Ο διακομιστής είναι η πηγή της αλήθειας: υπολογισμοί τιμών στην πλευρά του διακομιστή, ιδιόμορφες λειτουργίες, ποσά σε μικρές μονάδες