Mokėjimo būdai
Šiame puslapyje
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-methodišvardija įregistruotas kortelesPOST /v1/billing/teams/{teamId}/payment-method/defaultnustato 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