Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Maksājumu metodes

Nodarbība 6 no 14 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Pārvaldi savas maksājumu metodes
  2. Apskati maksājumu metodes
  3. Iestati noklusējuma maksājuma metodi
  4. Pieņemtās kartes
  5. Maksājumu pārvaldības labākā prakse
  6. Integrē savu infrastruktūrā
  7. Galvenās atziņas

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-method parāda reģistrēto karšu sarakstu
  • POST /v1/billing/teams/{teamId}/payment-method/default iestata 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