Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Makseviisid

Õppetund 6 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Halda oma makseviise
  2. Vaata makseviise
  3. Määra vaikimisi makseviis
  4. Aktsepteeritud kaardid
  5. Maksehalduse parimad tavad
  6. Jälgi aegumiskuupäevi
  7. Integreeri oma taristusse
  8. Peamised punktid

Halda oma makseviise

Haldus-API võimaldab sul vaadata registreeritud kaarte ja määrata vaikimisi makseviisi automaatsete mahaarvamiste jaoks. Selle haldamine on hädavajalik, et vältida teenuse katkemist ebaõnnestunud maksete tõttu.

Vaata makseviise

Kaartide haldamisel API kaudu on üks praktiline, kuid kriitiline eesmärk: tuvastada aeguv kaart enne, kui makse ebaõnnestub. Ebaõnnestunud arve ei ole lihtalt isoleeritud finantsintsident – see viib teenuse peatamiseni, mis sisuliselt tähendab tootmiskeskkonna riket, mille algpõhjus on raamatupidamises.

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

Vastus sisaldab iga kaardi kohta järgmist teavet: tüüp (Visa, Mastercard jne), viimased 4 numbrit, aegumiskuupäev ja staatus (aktiivne, vaikimisi).

Määra vaikimisi makseviis

Automaatsete mahaarvamiste jaoks kasutatava kaardi muutmiseks:

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 on identifikaator, mille tagastab vaate lõpp-punkt. Muudatus jõustub tulevaste maksete puhul, mitte juba käimasolevate puhul. Kui arve staatus muutub väärtuseks FAILED, siis vaikimisi kaardi vahetamine ei proovi seda automaatselt uuesti: paranda esmalt makseviis ja seejärel kontrolli asjaomase arve staatust.

Aktsepteeritud kaardid

xAI aktsepteerib API jaoks laia valikut maksekaarte:

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

Oluline piirang: India kaardid

Indias väljastatud maksekaarte ei aktsepteerita xAI API kasutamisel. See piirang kehtib ainult API kohta – tarbijatele mõeldud Grok teenuse (grok.com või mobiilirakenduste kaudu) maksed ei ole sellest piirangust mõjutatud.

Kui asud Indias ja soovid API-d kasutada, pead kasutama mõnes muus riigis väljastatud kaarti või uurima muid maksevõimalusi.

Maksehalduse parimad tavad

Hoia varukaarti

Registreeri vähemalt kaks makseviisi, eelistatavalt kahele erinevale kontole. See katab levinud ja kuluka stsenaariumi: ettevõtte kaart vahetatakse välja, keegi ei mõtle lisada API-d uuendatavate tellimuste nimekirja ja teenus peatub kolm nädalat hiljem. Ebaõnnestunud makse (staatus FAILED) võib viia sinu API võtmete ajutise peatamiseni.

Jälgi aegumiskuupäevi

Kontrolli regulaarselt oma registreeritud kaartide aegumiskuupäevi. Uuenda kaarte enne nende aegumist, et vältida katkestusi.

Maksete hoiatused

Kombineeri arvete vaatamine (GET /invoices) hoiatusskriptiga:

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!")
        # Saada teavitus (e-post, Slack jne)

Integreeri oma taristusse

Automatiseeritud kontrollimine

Integreeri perioodiline maksestaatuse kontrollimine oma seiresse:

# Igakuine kontrolliskript
#!/bin/bash
RESPONSE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY")

# Kontrolli, kas vaikimisi kaart on aktiivne
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')
"

Peamised punktid

  • GET /v1/billing/teams/{teamId}/payment-method loetleb registreeritud kaardid
  • POST /v1/billing/teams/{teamId}/payment-method/default määrab vaikimisi kaardi
  • Aktsepteeritakse Visa, Mastercard, AMEX, Discover, JCB ja UnionPay kaarte
  • India kaardid ei ole aktsepteeritud API jaoks (kuid toimivad grok.com-is)
  • Hoia alati registreeritud vähemalt kaks kaarti, et vältida katkestusi
  • Jälgi oma arvetes FAILED staatuseid, et tuvastada makseprobleeme