Metody płatności
Na tej stronie
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-methodwyświetla listę zarejestrowanych kartPOST /v1/billing/teams/{teamId}/payment-method/defaultustawia 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