💸 Οδηγός Πληρωμών με Pi

🚀 Πρώτο Βήμα: Εγγραφή στην Pi Developer Console

Πριν ξεκινήσεις με την ενσωμάτωση πληρωμών, πρέπει να εγγραφείς στο Pi Developer Portal και να δημιουργήσεις την εφαρμογή σου.

• Θα πάρεις ένα Server API Key για να κάνεις εξουσιοδοτημένες κλήσεις.
• Θα δηλώσεις redirect URIs, permissions και στοιχεία app.
• Μπορείς να κάνεις δοκιμές σε Testnet mode πριν πας στο live.

Αυτό είναι απαραίτητο για να αποκτήσεις πρόσβαση στο API και να ξεκινήσεις τις πληρωμές.

📌 Βασική Αρχή

Οι πληρωμές μέσω Pi ξεκινούν πάντα από το frontend με χρήση του Pi App Platform SDK. Το backend σου (server) χρησιμοποιείται μόνο για έγκριση και ολοκλήρωση της πληρωμής μέσω API.

🔎 1. Λήψη Πληροφοριών Πληρωμής

Για να πάρεις πληροφορίες μιας πληρωμής:

GET https://api.minepi.com/v2/payments/{payment_id}
Authorization: key {YOUR_SERVER_API_KEY}

Η απάντηση περιέχει όλα τα στοιχεία της πληρωμής σε μορφή PaymentDTO.

✅ 2. Έγκριση Πληρωμής (Server Approval)

Αφού ο χρήστης ξεκινήσει την πληρωμή, το SDK σου δίνει ένα paymentID. Στείλ’ το στον server σου και εκτέλεσε την εξής κλήση:

const paymentID = "eWXszS7lkfsRLHcrDRghLpDD5tHc";
const headers = { headers: { authorization: `key ${APIKEY}` } };
const postingURL = `https://api.minepi.com/v2/payments/${paymentID}/approve`;

let paymentDTO = await axios.post(postingURL, null, headers);
console.log(paymentDTO);

🧾 3. Ολοκλήρωση Πληρωμής (Server Completion)

Όταν ολοκληρωθεί η συναλλαγή στο frontend, παίρνεις ένα txid. Αυτό αποστέλλεται στον server σου για την τελική ολοκλήρωση:

const txid = "7a7ed20d3d72c365b9019baf8dc4c4e3cce4c08114d866e47ae157e3a796e9e7";
const tx_id = { txid: txid };
const headers = { headers: { authorization: `key ${APIKEY}` } };
const postingURL = `https://api.minepi.com/v2/payments/${paymentID}/complete`;

let paymentDTO = await axios.post(postingURL, tx_id, headers);
console.log(paymentDTO);

🧠 Τι είναι το PaymentDTO;

Είναι ένα JSON αντικείμενο που περιλαμβάνει:

• Ποσό & περιγραφή (memo)
• Στοιχεία χρήστη (uid, username)
• Κατάσταση πληρωμής: approved, verified, completed κ.λπ.
• Στοιχεία blockchain: txid, verified link κ.λπ.

⚠️ Προσοχή σε αυτά:

• Η δημιουργία πληρωμής γίνεται μόνο στο frontend μέσω SDK.
• Στο backend κάνεις approve και complete.
• Χρησιμοποίησε Server API Key για τις κλήσεις.

📚 Επιπλέον Πηγές

Για αναλυτικές λεπτομέρειες, δες την επίσημη τεκμηρίωση του Pi App Platform και την ενότητα “Pi Payment Flow”.