Metodi ta' Ħlas
F'din il-paġna
Immaniġġja l-metodi ta’ ħlas tiegħek
L-API tal-Ġestjoni (Management API) tippermettilek tara l-kards irreġistrati u tistabbilixxi l-metodu ta’ ħlas predefinit għall-ħlasijiet awtomatiċi. Li timmaniġġja dan huwa essenzjali biex tevita interruzzjonijiet tas-servizz ikkawżati minn ħlasijiet falluti.
Ara l-metodi ta’ ħlas
L-immaniġġjar tal-kards permezz tal-API għandu għan prattiku wieħed, iżda kritiku: tiskopri kard li qed tispiċċa qabel ma jfalli ħlas. Fattura falluta mhix sempliċiment inċident finanzjarju iżolat—twassal għas-sospensjoni tas-servizz, essenzjalment tfixkil fil-produzzjoni li joriġina fil-kontabbiltà.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Ir-risposta fiha informazzjoni għal kull kard: it-tip (Visa, Mastercard, eċċ.), l-aħħar 4 ċifri, id-data ta’ skadenza, u l-istatus (attiva, predefinita).
Stabbilixxi l-metodu ta’ ħlas predefinit
Biex tbiddel il-kard użata għall-ħlasijiet awtomatiċi:
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"
}'
L-paymentMethodId huwa l-identifikatur irritornat mill-endpoint tal-view. Il-bidla tidħol fis-seħħ għall-ħlasijiet li ġejjin—mhux dawk diġà għaddejjin. Jekk l-istatus ta’ fattura jinbidel għal FAILED, li tbiddel il-kard predefinita ma tipprovax awtomatikament mill-ġdid: issolvi l-metodu ta’ ħlas, imbagħad iċċekkja l-istatus tal-fattura affettwata.
Kards aċċettati
xAI taċċetta firxa wiesgħa ta’ kards ta’ ħlas għall-API:
- Visa
- Mastercard
- American Express (AMEX)
- Discover
- JCB
- UnionPay
Restrizzjoni importanti: Kards Indjani
Il-kards ta’ ħlas maħruġa fl-Indja mhumiex aċċettati biex tuża l-API ta’ xAI. Din ir-restrizzjoni tapplika biss għall-API—il-ħlasijiet għas-servizz tal-konsumatur Grok (permezz ta’ grok.com jew apps mobbli) mhumiex affettwati minn din il-limitazzjoni.
Jekk inti bbażat fl-Indja u trid tuża l-API, trid tuża kard maħruġa f’pajjiż ieħor jew tesplora għażliet oħra ta’ ħlas.
Prattiki tajba għall-ġestjoni tal-ħlasijiet
Żomm kard ta’ riżerva
Irreġistra mill-inqas żewġ metodi ta’ ħlas, preferibbilment fuq żewġ kontijiet differenti. Ix-xenarju li dan ikopri huwa komuni u għali: il-kard tal-kumpanija tiġi mibdula, ħadd ma jaħseb li jinkludi l-API fil-lista ta’ abbonamenti li għandhom jiġu aġġornati, u s-servizz jieqaf tliet ġimgħat wara. Ħlas fallut (status FAILED) jista’ jwassal għas-sospensjoni temporanja tal-API keys tiegħek.
Immonitorja l-iskadenzi
Iċċekkja regolarment id-dati ta’ skadenza tal-kards irreġistrati tiegħek. Aġġorna l-kards qabel ma jiskadu biex tevita kwalunkwe interruzzjoni.
Avviżi ta’ ħlas
Għaqqad il-viżwalizzazzjoni tal-fatturi (GET /invoices) ma’ skript ta’ allert:
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!")
# Ibgħat notifika (email, Slack, eċċ.)
Integra fl-infrastruttura tiegħek
Verifika awtomatizzata
Integra verifika perjodika tal-istatus tal-ħlas fil-monitoraġġ tiegħek:
# Skript ta' verifika ta' kull xahar
#!/bin/bash
RESPONSE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY")
# Iċċekkja jekk hemmx kard predefinita attiva
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')
"
Punti Ewlenin
GET /v1/billing/teams/{teamId}/payment-methodjelenka l-kards irreġistratiPOST /v1/billing/teams/{teamId}/payment-method/defaultjistabbilixxi l-kard predefinita- Il-kards Visa, Mastercard, AMEX, Discover, JCB, u UnionPay huma aċċettati
- Il-kards Indjani mhumiex aċċettati għall-API (iżda jaħdmu għal grok.com)
- Dejjem żomm mill-inqas żewġ kards irreġistrati biex tevita interruzzjonijiet
- Immonitorja l-istatus FAILED fil-fatturi tiegħek biex tiskopri problemi ta’ ħlas