Načini plačila
Na tej strani
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-methodizpiše seznam registriranih karticPOST /v1/billing/teams/{teamId}/payment-method/defaultnastavi 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