Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Metodi ta' Ħlas

Lezzjoni 6 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Immaniġġja l-metodi ta’ ħlas tiegħek
  2. Ara l-metodi ta’ ħlas
  3. Stabbilixxi l-metodu ta’ ħlas predefinit
  4. Kards aċċettati
  5. Prattiki tajba għall-ġestjoni tal-ħlasijiet
  6. Żomm kard ta’ riżerva
  7. Immonitorja l-iskadenzi
  8. Avviżi ta’ ħlas
  9. Integra fl-infrastruttura tiegħek
  10. Punti Ewlenin

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-method jelenka l-kards irreġistrati
  • POST /v1/billing/teams/{teamId}/payment-method/default jistabbilixxi 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