Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Načini plaćanja

Lekcija 6 od 14 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Upravljanje načinima plaćanja
  2. Pregled načina plaćanja
  3. Postavljanje zadane metode plaćanja
  4. Prihvaćene kartice
  5. Najbolje prakse za upravljanje plaćanjima
  6. Integracija u tvoju infrastrukturu
  7. Ključne točke

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-method izlistava registrirane kartice
  • POST /v1/billing/teams/{teamId}/payment-method/default postavlja 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