Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Spôsoby platby

Lekcia 6 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Správa spôsobov platby
  2. Zobrazenie spôsobov platby
  3. Nastavenie predvoleného spôsobu platby
  4. Akceptované karty
  5. Osvedčené postupy pri správe platieb
  6. Integrácia do tvojej infraštruktúry
  7. Kľúčové poznatky

Správa spôsobov platby

Management API ti umožňuje zobraziť registrované karty a nastaviť predvolený spôsob platby pre automatické účtovanie. Správa tohto nastavenia je nevyhnutná na predchádzanie prerušeniam služby spôsobeným neúspešnými platbami.

Zobrazenie spôsobov platby

Správa kariet prostredníctvom API má jeden praktický, no kritický cieľ: odhaliť kartu, ktorej platnosť čoskoro vyprší, skôr, než dôjde k zlyhaniu platby. Nezaplatená faktúra nie je len izolovanou finančnou udalosťou – vedie k pozastaveniu služby, čo je v podstate výpadok produkcie spôsobený účtovníctvom.

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

Odozva obsahuje informácie o každej karte: typ (Visa, Mastercard atď.), posledné 4 číslice, dátum exspirácie a stav (aktívna, predvolená).

Nastavenie predvoleného spôsobu platby

Ak chceš zmeniť kartu používanú na automatické účtovanie:

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átený koncovým bodom pre zobrazenie. Zmena sa prejaví pri nadchádzajúcich platbách, nie pri tých, ktoré už prebiehajú. Ak sa stav faktúry zmení na FAILED (zlyhané), zmena predvolenej karty ju automaticky nepokusí znova zaplatiť: najprv oprav spôsob platby a následne skontroluj stav dotknutej faktúry.

Akceptované karty

xAI akceptuje širokú škálu platobných kariet pre API:

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

Dôležité obmedzenie: Indické karty

Platobné karty vydané v Indii nie sú akceptované na používanie API xAI. Toto obmedzenie sa vzťahuje výlučne na API – platby za spotrebiteľskú službu Grok (cez grok.com alebo mobilné aplikácie) týmto obmedzením nie sú dotknuté.

Ak sídliš v Indii a chceš používať API, musíš použiť kartu vydanú v inej krajine alebo preskúmať iné možnosti platby.

Osvedčené postupy pri správe platieb

Mať záložnú kartu

Zaregistruj si aspoň dva spôsoby platby, ideálne na dvoch rôznych účtoch. Tento postup pokrýva bežný a nákladný scenár: firemná karta sa vymení, nikto nezahrnie API do zoznamu predplatných na aktualizáciu a o tri týždne sa služba zastaví. Neúspešná platba (stav FAILED) môže viesť k dočasnému pozastaveniu tvojich API kľúčov.

Monitorovanie dátumov exspirácie

Pravidelne kontroluj dátumy exspirácie registrovaných kariet. Aktualizuj karty skôr, než im vyprší platnosť, aby si predišiel akémukoľvek prerušeniu.

Upozornenia na platby

Skombinuj zobrazovanie faktúr (GET /invoices) so skriptom na upozornenia:

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

Integrácia do tvojej infraštruktúry

Automatizovaná verifikácia

Zaraď pravidelnú verifikáciu stavu platieb do svojho monitorovania:

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

# Skontroluj, či je predvolená karta aktívna
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')
"

Kľúčové poznatky

  • GET /v1/billing/teams/{teamId}/payment-method vypíše zoznam registrovaných kariet
  • POST /v1/billing/teams/{teamId}/payment-method/default nastaví predvolenú kartu
  • Akceptované sú karty Visa, Mastercard, AMEX, Discover, JCB a UnionPay
  • Indické karty nie sú akceptované pre API (fungujú však pre grok.com)
  • Vždy maj zaregistrované aspoň dve karty, aby si predišiel prerušeniam
  • Monitoruj stavy FAILED na svojich faktúrach, aby si včas odhalil problémy s platbami