Makseviisid
Sellel lehel
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-methodloetleb registreeritud kaardidPOST /v1/billing/teams/{teamId}/payment-method/defaultmää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