Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Mokėjimo būdai

Paskaita 6 iš 14 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Tvarkyk savo mokėjimo būdus
  2. Peržiūrėk mokėjimo būdus
  3. Nustatyk numatytąjį mokėjimo būdą
  4. Priimamos kortelės
  5. Mokėjimų valdymo geriausios praktikos
  6. Mokėjimų įspėjimai
  7. Integruok į savo infrastruktūrą
  8. Svarbiausi punktai

Tvarkyk savo mokėjimo būdus

Valdymo API (Management API) leidžia peržiūrėti įregistruotas korteles ir nustatyti numatytąjį mokėjimo būdą automatiniams nurašymams. Tai būtina norint išvengti paslaugų sutrikimų dėl nepavykusių mokėjimų.

Peržiūrėk mokėjimo būdus

Kortelių valdymas per API turi vieną praktinį, tačiau kritinį tikslą: aptikti netrukus galiojimo laiką baigsiančią kortelę prieš nepavykstant nurašymui. Nepavykusi sąskaita faktūra nėra tik izoliuotas finansinis incidentas – tai lemia paslaugų sustabdymą, iš esmės sukeliant gamybinį trikdį, kurio šaknys – apskaitoje.

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

Atsakyme pateikiama informacija apie kiekvieną kortelę: tipas („Visa“, „Mastercard“ ir kt.), paskutiniai 4 skaitmenys, galiojimo data ir būsena (aktyvi, numatytoji).

Nustatyk numatytąjį mokėjimo būdą

Norėdami pakeisti kortelę, naudojamą automatiniams nurašymams:

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 yra identifikatorius, grąžinamas peržiūros galinio taško (endpoint). Pakeitimas įsigalioja būsimiems nurašymams, o ne tiems, kurie jau vykdomi. Jei sąskaitos faktūros būsena pasikeičia į FAILED, numatytosios kortelės pakeitimas jos automatiškai nebandys apmokėti iš naujo: pirmiausia sutvarkyk mokėjimo būdą, tada patikrink paveiktos sąskaitos faktūros būseną.

Priimamos kortelės

xAI API priima įvairias mokėjimo korteles:

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

Svarbus apribojimas: Indijos kortelės

Indijoje išduotos mokėjimo kortelės nėra priimamos naudojant xAI API. Šis apribojimas taikomas tik API – mokėjimai už vartotojams skirtą „Grok“ paslaugą (per grok.com arba mobiliąsias programėles) šiam apribojimui nepaklūsta.

Jei esi Indijoje ir nori naudoti API, privalai naudoti kitoje šalyje išduotą kortelę arba ieškoti kitų mokėjimo būdų.

Mokėjimų valdymo geriausios praktikos

Turėk atsarginę kortelę

Įregistruok bent du mokėjimo būdus, pageidautina iš dviejų skirtingų sąskaitų. Tai apsaugo nuo dažno ir brangiai kainuojančio scenarijaus: įmonės kortelė pakeičiama, niekas nepagalvoja atnaujinti jos API prenumeratų sąraše, ir po trijų savaičių paslauga sustoja. Nepavykęs mokėjimas (būsena FAILED) gali lemti laikiną tavo API raktų sustabdymą.

Stebėk galiojimo pabaigos datas

Reguliariai tikrink įregistruotų kortelių galiojimo datas. Atnaujink korteles prieš joms nustojant galioti, kad išvengtum bet kokių sutrikimų.

Mokėjimų įspėjimai

Sujunk sąskaitų faktūrų peržiūrą (GET /invoices) su įspėjimų scenarijumi:

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.)

Integruok į savo infrastruktūrą

Automatizuotas tikrinimas

Integruok periodinį mokėjimų būsenos tikrinimą į savo stebėsenos sistemą:

# 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')
"

Svarbiausi punktai

  • GET /v1/billing/teams/{teamId}/payment-method išvardija įregistruotas korteles
  • POST /v1/billing/teams/{teamId}/payment-method/default nustato numatytąją kortelę
  • Priimamos „Visa“, „Mastercard“, AMEX, „Discover“, JCB ir „UnionPay“ kortelės
  • Indijos kortelės API nėra priimamos (tačiau veikia grok.com svetainėje)
  • Visada turėk įregistruotas bent dvi korteles, kad išvengtum sutrikimų
  • Stebėk FAILED būsenas savo sąskaitose faktūrose, kad laiku aptiktum mokėjimo problemas