Przejdź do głównej treści
Polski— Wybierz język
Menu

Metody płatności

Lekcja 6 z 14 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Zarządzanie metodami płatności
  2. Przeglądanie metod płatności
  3. Ustawianie domyślnej metody płatności
  4. Akceptowane karty
  5. Najlepsze praktyki zarządzania płatnościami
  6. Integracja z infrastrukturą
  7. Kluczowe wnioski

Zarządzanie metodami płatności

Interfejs API zarządzania pozwala przeglądać zarejestrowane karty i ustawiać domyślną metodę płatności dla automatycznych obciążeń. Zarządzanie tym aspektem jest kluczowe, aby uniknąć przerw w działaniu usługi spowodowanych nieudanymi płatnościami.

Przeglądanie metod płatności

Zarządzanie kartami przez API ma jeden praktyczny cel, ale jest on krytyczny: wykrycie karty, której ważność niedługo wygaśnie, zanim nastąpi nieudane obciążenie. Nieopłacona faktura to nie tylko izolowane zdarzenie finansowe – prowadzi do zawieszenia usługi, co w istocie oznacza awarię środowiska produkcyjnego pochodzącą z działu księgowości.

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

Odpowiedź zawiera informacje dla każdej karty: typ (Visa, Mastercard itp.), ostatnie 4 cyfry, datę ważności oraz status (aktywna, domyślna).

Ustawianie domyślnej metody płatności

Aby zmienić kartę używaną do automatycznych obciążeń:

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 to identyfikator zwracany przez punkt końcowy przeglądania. Zmiana zaczyna obowiązywać przy nadchodzących obciążeniach – nie dotyczy tych już przetwarzanych. Jeśli status faktury zmieni się na FAILED, przełączenie domyślnej karty nie spowoduje automatycznej ponownej próby: napraw metodę płatności, a następnie sprawdź status affected faktury.

Akceptowane karty

xAI akceptuje szeroki zakres kart płatniczych do korzystania z API:

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

Ważne ograniczenie: karty indyjskie

Karty płatnicze wydane w Indiach nie są akceptowane do korzystania z API xAI. Ograniczenie to dotyczy wyłącznie API – płatności za usługę konsumencką Grok (poprzez grok.com lub aplikacje mobilne) nie podlegają temu ograniczeniu.

Jeśli mieszkasz w Indiach i chcesz korzystać z API, musisz użyć karty wydanej w innym kraju lub rozważyć inne opcje płatności.

Najlepsze praktyki zarządzania płatnościami

Miej kartę zapasową

Zarejestruj co najmniej dwie metody płatności, najlepiej na dwóch różnych kontach. Scenariusz, którego to dotyczy, jest powszechny i kosztowny: karta firmowa zostaje wymieniona, nikt nie pomyśli o uwzględnieniu API na liście subskrypcji do aktualizacji, a usługa przestaje działać trzy tygodnie później. Nieudana płatność (status FAILED) może prowadzić do tymczasowego zawieszenia Twoich kluczy API.

Monitoruj daty ważności

Regularnie sprawdzaj daty ważności zarejestrowanych kart. Aktualizuj karty przed ich wygaśnięciem, aby uniknąć wszelkich przerw.

Alerty płatnicze

Połącz przeglądanie faktur (GET /invoices) ze skryptem alertowym:

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.)

Integracja z infrastrukturą

Automatyczna weryfikacja

Zintegruj okresową weryfikację statusu płatności ze swoim monitoringiem:

# 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')
"

Kluczowe wnioski

  • GET /v1/billing/teams/{teamId}/payment-method wyświetla listę zarejestrowanych kart
  • POST /v1/billing/teams/{teamId}/payment-method/default ustawia kartę domyślną
  • Akceptowane są karty Visa, Mastercard, AMEX, Discover, JCB i UnionPay
  • Karty indyjskie nie są akceptowane do API (ale działają na grok.com)
  • Zawsze miej zarejestrowane co najmniej dwie karty, aby uniknąć przerw
  • Monitoruj statusy FAILED na fakturach, aby wykrywać problemy z płatnościami