Maksājumu metodes
Šajā lapā
Pārvaldi savas maksājumu metodes
Management API ļauj apskatīt reģistrētās kartes un iestatīt noklusējuma maksājuma metodi automātiskajiem maksājumiem. Tas ir būtiski, lai izvairītos no pakalpojumu pārtraukumiem neveiksmīgu maksājumu dēļ.
Apskati maksājumu metodes
Karšu pārvaldībai, izmantojot API, ir viens praktisks, bet kritisks mērķis: noteikt karti, kurai drīz beigsies derīguma termiņš, pirms maksājums neizdodas. Neapmaksāts rēķins nav tikai izolēts finanšu incidents — tas izraisa pakalpojuma apturēšanu, kas būtībā ir ražošanas vidē notiekoša darbības pārtraukuma cēlonis, kas sākas grāmatvedībā.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Atbilde satur informāciju par katru karti: veidu (Visa, Mastercard u.c.), pēdējos 4 ciparus, derīguma termiņu un statusu (aktīva, noklusējuma).
Iestati noklusējuma maksājuma metodi
Lai nomainītu karti, ko izmanto automātiskajiem maksājumiem:
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 ir identifikators, ko atgriež skatīšanas galapunkts. Izmaiņas stājas spēkā turpmākajiem maksājumiem, nevis tiem, kas jau tiek apstrādāti. Ja rēķina statuss mainās uz FAILED (neizdevies), noklusējuma kartes maiņa to automātiski nemēģina atkārtoti apmaksāt: vispirms sakārto maksājuma metodi, pēc tam pārbaudi attiecīgā rēķina statusu.
Pieņemtās kartes
xAI API norēķiniem pieņem plašu maksājumu karšu klāstu:
- Visa
- Mastercard
- American Express (AMEX)
- Discover
- JCB
- UnionPay
Svarīgs ierobežojums: Indijas kartes
Indijā izdotās maksājumu kartes netiek pieņemtas xAI API izmantošanai. Šis ierobežojums attiecas tikai uz API — maksājumiem par patērētāju paredzēto Grok pakalpojumu (izmantojot grok.com vai mobilās lietotnes) šis ierobežojums neattiecas.
Ja atrodaties Indijā un vēlaties izmantot API, jums jāizmanto citā valstī izdota karte vai jāizpēta citas maksājumu iespējas.
Maksājumu pārvaldības labākā prakse
Glabā rezerves karti
Reģistrē vismaz divas maksājumu metodes, vēlams divos dažādos kontos. Šis scenārijs ir bieži sastopams un dārgs: uzņēmuma karte tiek nomainīta, neviens nepadomā iekļaut API abonementu atjaunojamo pakalpojumu sarakstā, un pakalpojums apstājas trīs nedēļas vēlāk. Neveiksmīgs maksājums (statuss FAILED) var izraisīt tava API atslēgu pagaidu apturēšanu.
Uzraugi derīguma termiņus
Regulāri pārbaudi reģistrēto karšu derīguma termiņus. Atjauno kartes pirms to derīguma termiņa beigām, lai izvairītos no jebkādiem pārtraukumiem.
Maksājumu brīdinājumi
Apvieno rēķinu apskati (GET /invoices) ar brīdinājumu skriptu:
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.)
Integrē savu infrastruktūrā
Automatizēta verificēšana
Integrē periodisku maksājumu statusa verificēšanu savā uzraudzībā:
# 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')
"
Galvenās atziņas
GET /v1/billing/teams/{teamId}/payment-methodparāda reģistrēto karšu sarakstuPOST /v1/billing/teams/{teamId}/payment-method/defaultiestata noklusējuma karti- Tiek pieņemtas Visa, Mastercard, AMEX, Discover, JCB un UnionPay kartes
- Indijas kartes API izmantošanai netiek pieņemtas (bet darbojas grok.com)
- Vienmēr glabā vismaz divas reģistrētas kartes, lai izvairītos no pārtraukumiem
- Uzraugi FAILED statusus savos rēķinos, lai laicīgi noteiktu maksājumu problēmas