Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Platební metody

Lekce 6 z 14 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Správa platebních metod
  2. Zobrazení platebních metod
  3. Nastavení výchozí platební metody
  4. Akceptované karty
  5. Osvědčené postupy pro správu plateb
  6. Integrace do tvé infrastruktury
  7. Klíčové poznatky

Správa platebních metod

Management API ti umožňuje zobrazit registrované karty a nastavit výchozí platební metodu pro automatické platby. Správa tohoto nastavení je zásadní pro předcházení přerušení služby způsobeným neúspěšnými platbami.

Zobrazení platebních metod

Správa karet prostřednictvím API má jeden praktický, ale kritický cíl: odhalit kartu blížící se konci platnosti dříve, než dojde k selhání platby. Neuhrazená faktura není jen izolovanou finanční událostí – vede k pozastavení služby, což je v podstatě výpadek produkce vzniklý v účetnictví.

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

Odpověď obsahuje informace o každé kartě: typ (Visa, Mastercard atd.), poslední 4 číslice, datum expirace a stav (aktivní, výchozí).

Nastavení výchozí platební metody

Pro změnu karty používané pro automatické platby:

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 je identifikátor vrácený koncovým bodem pro zobrazení. Změna se projeví u nadcházejících plateb, nikoliv u těch, které již probíhají. Pokud se stav faktury změní na FAILED, přepnutí výchozí karty ji automaticky nezopakuje: nejprve oprav platební metodu a poté zkontroluj stav dotčené faktury.

Akceptované karty

xAI přijímá pro API širokou škálu platebních karet:

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

Důležité omezení: Indické karty

Platební karty vydané v Indii nejsou akceptovány pro používání xAI API. Toto omezení se týká pouze API – platby za spotřebitelskou službu Grok (prostřednictvím grok.com nebo mobilních aplikací) tímto omezením nejsou dotčeny.

Pokud sídlíš v Indii a chceš používat API, musíš použít kartu vydanou v jiné zemi nebo prozkoumat jiné platební možnosti.

Osvědčené postupy pro správu plateb

Měj záložní kartu

Zaregistruj alespoň dvě platební metody, ideálně na dvou různých účtech. Tento scénář je běžný a nákladný: firemní karta je vyměněna, nikdo nepomyslí na zahrnutí API do seznamu předplatných k aktualizaci a služba se o tři týdny později zastaví. Neúspěšná platba (stav FAILED) může vést k dočasnému pozastavení tvých API klíčů.

Sleduj data expirace

Pravidelně kontroluj data expirace svých registrovaných karet. Aktualizuj karty před jejich vypršením, aby nedošlo k žádnému přerušení.

Upozornění na platby

Zkombinuj zobrazování faktur (GET /invoices) se skriptem pro upozornění:

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!")
        # Odeslat oznámení (e-mail, Slack atd.)

Integrace do tvé infrastruktury

Automatizovaná verifikace

Integruj pravidelnou verifikaci stavu plateb do svého monitoringu:

# Měsíční ověřovací skript
#!/bin/bash
RESPONSE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY")

# Zkontroluj, zda je výchozí karta aktivní
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')
"

Klíčové poznatky

  • GET /v1/billing/teams/{teamId}/payment-method vypíše registrované karty
  • POST /v1/billing/teams/{teamId}/payment-method/default nastaví výchozí kartu
  • Akceptovány jsou karty Visa, Mastercard, AMEX, Discover, JCB a UnionPay
  • Indické karty nejsou akceptovány pro API (fungují však pro grok.com)
  • Vždy měj zaregistrované alespoň dvě karty, abys předešel přerušením
  • Sleduj stavy FAILED ve svých fakturách, abys odhalil problémy s platbami