Načini plaćanja
Na ovoj stranici
Upravljanje načinima plaćanja
Management API omogućuje ti pregled registriranih kartica i postavljanje zadane metode plaćanja za automatska zaduženja. Upravljanje ovim postavkama ključno je kako bi se izbjegli prekidi usluge uzrokovani neuspjelim plaćanjima.
Pregled načina plaćanja
Upravljanje karticama putem API-ja ima jedan praktičan, ali kritičan cilj: otkriti karticu kojoj uskoro istječe rok valjanosti prije nego što dođe do neuspjelog zaduženja. Neuspjela faktura nije samo izolirani financijski incident – ona dovodi do suspenzije usluge, što je u biti zastoj u proizvodnji koji potječe iz računovodstva.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odgovor sadrži informacije za svaku karticu: vrstu (Visa, Mastercard itd.), zadnje 4 znamenke, datum isteka i status (aktivna, zadana).
Postavljanje zadane metode plaćanja
Za promjenu kartice koja se koristi za automatska zaduženja:
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 vraćen od strane endpointa za pregled. Promjena stupa na snagu za nadolazeća zaduženja – ne i za ona koja su već u tijeku. Ako se status fakture promijeni u FAILED, promjena zadane kartice neće automatski ponoviti pokušaj naplate: prvo ispravi metodu plaćanja, a zatim provjeri status predmetne fakture.
Prihvaćene kartice
xAI prihvaća širok raspon platnih kartica za API:
- Visa
- Mastercard
- American Express (AMEX)
- Discover
- JCB
- UnionPay
Važno ograničenje: indijske kartice
Platne kartice izdane u Indiji nisu prihvaćene za korištenje xAI API-ja. Ovo ograničenje vrijedi isključivo za API – plaćanja za potrošačku uslugu Grok (putem grok.com ili mobilnih aplikacija) nisu podložna ovom ograničenju.
Ako se nalaziš u Indiji i želiš koristiti API, moraš upotrijebiti karticu izdanu u drugoj zemlji ili istražiti druge opcije plaćanja.
Najbolje prakse za upravljanje plaćanjima
Imaj rezervnu karticu
Registriraj barem dvije metode plaćanja, po mogućnosti na dva različita računa. Scenarij koji ovime pokrivaš čest je i skup: korporativna kartica se zamijeni, nitko se ne sjeti uključiti API na popis pretplata koje treba ažurirati i usluga prestane raditi tri tjedna kasnije. Neuspjelo plaćanje (status FAILED) može dovesti do privremene suspenzije tvojih API ključeva.
Prati datume isteka
Redovito provjeravaj datume isteka svojih registriranih kartica. Ažuriraj kartice prije nego što im istekne rok valjanosti kako bi izbjegao bilo kakav prekid.
Alerti za plaćanja
Kombiniraj pregled faktura (GET /invoices) sa skriptom za upozorenja:
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!")
# Pošalji obavijest (e-mail, Slack, itd.)
Integracija u tvoju infrastrukturu
Automatizirana verifikacija
Integriraj periodičnu verifikaciju statusa plaćanja u svoj sustav nadzora:
# Mjesečna skripta za verifikaciju
#!/bin/bash
RESPONSE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY")
# Provjeri je li zadana kartica aktivna
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 točke
GET /v1/billing/teams/{teamId}/payment-methodizlistava registrirane karticePOST /v1/billing/teams/{teamId}/payment-method/defaultpostavlja zadanu karticu- Prihvaćene su kartice Visa, Mastercard, AMEX, Discover, JCB i UnionPay
- Indijske kartice nisu prihvaćene za API (ali rade za grok.com)
- Uvijek drži registrirane barem dvije kartice kako bi izbjegao prekide
- Prati statuse FAILED na svojim fakturama kako bi otkrio probleme s plaćanjem