Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Μέθοδοι Πληρωμής

Μάθημα 6 / 14 Ενημερώθηκε 29 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Διαχείριση των μεθόδων πληρωμής σας
  2. Προβολή μεθόδων πληρωμής
  3. Ορισμός της προεπιλεγμένης μεθόδου πληρωμής
  4. Αποδεκτές κάρτες
  5. Βέλτιστες πρακτικές διαχείρισης πληρωμών
  6. Ενσωμάτωση στην υποδομή σας
  7. Βασικά σημεία

Διαχείριση των μεθόδων πληρωμής σας

Το Management API σάς επιτρέπει να προβάλλετε τις καταχωρημένες κάρτες και να ορίζετε την προεπιλεγμένη μέθοδο πληρωμής για τις αυτόματες χρεώσεις. Η διαχείριση αυτή είναι απαραίτητη για την αποφυγή διακοπών της υπηρεσίας λόγω αποτυχημένων πληρωμών.

Προβολή μεθόδων πληρωμής

Η διαχείριση καρτών μέσω του API έχει έναν πρακτικό στόχο, αλλά κρίσιμο: να εντοπίσετε μια κάρτα που πρόκειται να λήξει πριν αποτύχει μια χρέωση. Ένας αποτυχημένος τιμολόγιο δεν είναι απλώς ένα μεμονωμένο οικονομικό περιστατικό· οδηγεί σε αναστολή της υπηρεσίας, ουσιαστικά σε διακοπή παραγωγής που πηγάζει από το λογιστήριο.

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Η απόκριση περιέχει πληροφορίες για κάθε κάρτα: τον τύπο (Visa, Mastercard κ.λπ.), τα τελευταία 4 ψηφία, την ημερομηνία λήξης και την κατάσταση (ενεργή, προεπιλεγμένη).

Ορισμός της προεπιλεγμένης μεθόδου πληρωμής

Για να αλλάξετε την κάρτα που χρησιμοποιείται για τις αυτόματες χρεώσεις:

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method/default" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethodId": "pm_abc123"
  }'

Το paymentMethodId είναι το αναγνωριστικό που επιστρέφεται από το endpoint προβολής. Η αλλαγή τίθεται σε ισχύ για τις επερχόμενες χρεώσεις—όχι για εκείνες που βρίσκονται ήδη σε εξέλιξη. Εάν η κατάσταση ενός τιμολογίου αλλάξει σε FAILED, η αλλαγή της προεπιλεγμένης κάρτας δεν προκαλεί αυτόματη επανάληψη της πληρωμής: διορθώστε πρώτα τη μέθοδο πληρωμής και στη συνέχεια ελέγξτε την κατάσταση του συγκεκριμένου τιμολογίου.

Αποδεκτές κάρτες

Το xAI δέχεται ένα ευρύ φάσμα καρτών πληρωμής για το API:

  • Visa
  • Mastercard
  • American Express (AMEX)
  • Discover
  • JCB
  • UnionPay

Σημαντικός περιορισμός: Ινδικές κάρτες

Οι κάρτες πληρωμής που εκδίδονται στην Ινδία δεν γίνονται δεκτές για τη χρήση του xAI API. Αυτός ο περιορισμός ισχύει μόνο για το API· οι πληρωμές για την υπηρεσία Grok για καταναλωτές (μέσω του grok.com ή των εφαρμογών για κινητά) δεν επηρεάζονται από αυτόν τον περιορισμό.

Εάν βρίσκεστε στην Ινδία και θέλετε να χρησιμοποιήσετε το API, πρέπει να χρησιμοποιήσετε κάρτα που έχει εκδοθεί σε άλλη χώρα ή να εξερευνήσετε άλλες επιλογές πληρωμής.

Βέλτιστες πρακτικές διαχείρισης πληρωμών

Διατηρήστε μια εφεδρική κάρτα

Καταχωρήστε τουλάχιστον δύο μεθόδους πληρωμής, κατά προτίμηση σε δύο διαφορετικούς λογαριασμούς. Το σενάριο που καλύπτει αυτό είναι συχνό και δαπανηρό: η εταιρική κάρτα αντικαθίσταται, κανείς δεν σκέφτεται να συμπεριλάβει το API στη λίστα των συνδρομών προς ενημέρωση και η υπηρεσία διακόπτεται τρεις εβδομάδες αργότερα. Μια αποτυχημένη πληρωμή (κατάσταση FAILED) μπορεί να οδηγήσει σε προσωρινή αναστολή των κλειδιών API σας.

Παρακολούθηση λήξεων

Ελέγχετε τακτικά τις ημερομηνίες λήξης των καταχωρημένων καρτών σας. Ενημερώνετε τις κάρτες πριν λήξουν για να αποφύγετε οποιαδήποτε διακοπή.

Ειδοποιήσεις πληρωμών

Συνδυάστε την προβολή τιμολογίων (GET /invoices) με ένα σενάριο ειδοποίησης:

import requests

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

response = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/invoices?billingCycle.year=2026&billingCycle.month=4",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)

invoices = response.json()
for invoice in invoices.get("invoices", []):
    if invoice.get("status") == "FAILED":
        print(f"ALERT: invoice {invoice['id']} failed!")
        # Send a notification (email, Slack, etc.)

Ενσωμάτωση στην υποδομή σας

Αυτοματοποιημένη επαλήθευση

Ενσωματώστε την περιοδική επαλήθευση της κατάστασης πληρωμών στην παρακολούθησή σας:

# Monthly verification script
#!/bin/bash
RESPONSE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY")

# Check if a default card is active
echo "$RESPONSE" | python3 -c "
import sys, json
data = json.load(sys.stdin)
methods = data.get('paymentMethods', [])
if not methods:
    print('ALERT: no payment method registered')
    sys.exit(1)
default = [m for m in methods if m.get('isDefault')]
if not default:
    print('ALERT: no default payment method')
    sys.exit(1)
print('OK: default payment method active')
"

Βασικά σημεία

  • Το GET /v1/billing/teams/{teamId}/payment-method εμφανίζει τη λίστα των καταχωρημένων καρτών
  • Το POST /v1/billing/teams/{teamId}/payment-method/default ορίζει την προεπιλεγμένη κάρτα
  • Γίνονται δεκτές κάρτες Visa, Mastercard, AMEX, Discover, JCB και UnionPay
  • Οι ινδικές κάρτες δεν γίνονται δεκτές για το API (αλλά λειτουργούν για το grok.com)
  • Διατηρείτε πάντα τουλάχιστον δύο καταχωρημένες κάρτες για την αποφυγή διακοπών
  • Παρακολουθείτε τις καταστάσεις FAILED στα τιμολόγιά σας για τον εντοπισμό προβλημάτων πληρωμής