Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Načini plačila

Lekcija 6 od 14 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Upravljanje načinov plačila
  2. Ogled načinov plačila
  3. Nastavitev privzetega načina plačila
  4. Sprejete kartice
  5. Najboljše prakse za upravljanje plačil
  6. Integracija v tvojo infrastrukturo
  7. Ključne ugotovitve

Upravljanje načinov plačila

Upravni API ti omogoča ogled registriranih kartic in nastavitev privzetega načina plačila za samodejna bremenitve. Upravljanje tega je ključno za preprečevanje prekinitev storitev zaradi neuspešnih plačil.

Ogled načinov plačila

Upravljanje kartic prek API-ja ima en praktičen cilj, ki pa je kritičen: odkriti kartico, ki ji bo kmalu potekel rok veljavnosti, preden bremenitev ne uspe. Neuspešen račun ni le osamljen finančni incident – vodi do začasne prekinitve storitve, kar je v bistvu izpad v proizvodnem okolju, ki izvira iz računovodstva.

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

Odgovor vsebuje informacije za vsako kartico: vrsto (Visa, Mastercard itd.), zadnje 4 števke, datum poteka veljavnosti in stanje (aktivna, privzeta).

Nastavitev privzetega načina plačila

Če želiš spremeniti kartico, ki se uporablja za samodejna bremenitve:

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 identifikator, ki ga vrne končna točka za ogled. Sprememba začne veljati za prihodnja bremenitve – ne za tista, ki so že v teku. Če se stanje računa spremeni v FAILED (neuspešno), sprememba privzete kartice samodejno ne ponovi poskusa plačila: najprej popravi način plačila, nato pa preveri stanje prizadetega računa.

Sprejete kartice

xAI sprejema širok nabor plačilnih kartic za API:

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

Pomembna omejitev: indijske kartice

Plačilne kartice, izdane v Indiji, niso sprejete za uporabo API-ja xAI. Ta omejitev velja samo za API – plačila za potrošniško storitev Grok (prek grok.com ali mobilnih aplikacij) niso podvržena tej omejitvi.

Če imaš sedež v Indiji in želiš uporabljati API, moraš uporabiti kartico, izdano v drugi državi, ali raziskati druge možnosti plačila.

Najboljše prakse za upravljanje plačil

Imej rezervno kartico

Registriraj vsaj dva načina plačila, po možnosti na dveh različnih računih. Scenarij, ki ga s tem pokrivaš, je pogost in drag: podjetniška kartica se zamenja, nihče ne pomisli, da bi vključil API na seznam naročnin za posodobitev, in storitev se tri tedne kasneje ustavi. Neuspešno plačilo (stanje FAILED) lahko vodi do začasne prekinitve tvojih API ključev.

Spremljanje datumov poteka veljavnosti

Redno preverjaj datume poteka veljavnosti svojih registriranih kartic. Kartice posodobi pred njihovim potekom, da se izogneš kakršni koli prekinitvi.

Opozorila o plačilih

Združi ogled računov (GET /invoices) s skripto za opozarjanje:

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

Integracija v tvojo infrastrukturo

Samodejno preverjanje

V svoje nadzorne sisteme integriraj periodično preverjanje stanja plačil:

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

Ključne ugotovitve

  • GET /v1/billing/teams/{teamId}/payment-method izpiše seznam registriranih kartic
  • POST /v1/billing/teams/{teamId}/payment-method/default nastavi privzeto kartico
  • Sprejete so kartice Visa, Mastercard, AMEX, Discover, JCB in UnionPay
  • Indijske kartice niso sprejete za API (delujejo pa za grok.com)
  • Vedno imej registrirani vsaj dve kartici, da se izogneš prekinitvam
  • Spremljaj stanja FAILED na svojih računih, da pravočasno odkriješ težave s plačili