Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Modhanna Íocaíochta

Ceacht 6 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Bainistigh do mhodhanna íocaíochta
  2. Féach ar mhodhanna íocaíochta
  3. Socraigh an modh íocaíochta réamhshocraithe
  4. Cártaí glactha
  5. Dea-chleachtais bhainistíochta íocaíochta
  6. Comhtháthaigh le do bhonneagar
  7. Príomhphointí

Bainistigh do mhodhanna íocaíochta

Ligeann an Management API duit cártaí cláraithe a fheiceáil agus an modh íocaíochta réamhshocraithe a shocrú do mhuirir uathoibríocha. Tá sé ríthábhachtach é seo a bhainistiú chun cur isteach ar sheirbhísí de bharr íocaíochtaí teipthe a sheachaint.

Féach ar mhodhanna íocaíochta

Tá cuspóir praiticiúil amháin ag baint le cártaí a bhainistiú tríd an API, ach tá sé ríthábhachtach: braitheann tú cárta atá ar tí dul in éag sula dteipeann muirear. Ní heachtra airgeadais aonair amháin é sonraisce teipthe – is cúis le fionraí seirbhíse é, rud a chiallaíonn go bunúsach briseadh amach táirgeachta a thosaíonn sa chuntasaíocht.

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

Tá faisnéis do gach cárta sa fhreagra: an cineál (Visa, Mastercard, srl.), na 4 dhigit dheireanacha, an dáta éaga, agus an stádas (gníomhach, réamhshocraithe).

Socraigh an modh íocaíochta réamhshocraithe

Chun an cárta a úsáidtear le haghaidh muirir uathoibríocha a athrú:

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"
  }'

Is é an paymentMethodId an t-aitheantóir a thugtar ar ais ag an bpointe deiridh féachana. Tagann an t-athrú i bhfeidhm do mhuirir atá le teacht – ní dóibh siúd atá ar siúl cheana féin. Má athraíonn stádas sonraisce go FAILED, ní dhéanann an cárta réamhshocraithe a athrú iarracht athuair air go huathoibríoch: socraigh an modh íocaíochta ar dtús, ansin seiceáil stádas an tsonraisce lena mbaineann.

Cártaí glactha

Glacann xAI raon leathan cártaí íocaíochta don API:

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

Srian tábhachtach: Cártaí Indiacha

Ní ghlactar le cártaí íocaíochta a eisiúint san India chun an xAI API a úsáid. Ní bhaineann an srian seo ach leis an API – níl tionchar ag an teorainn seo ar íocaíochtaí don tseirbhís tomhaltóra Grok (trí grok.com nó aipeanna soghluaiste).

Má tá tú bunaithe san India agus más mian leat an API a úsáid, caithfidh tú cárta a eisiúint i dtír eile a úsáid nó roghanna íocaíochta eile a iniúchadh.

Dea-chleachtais bhainistíochta íocaíochta

Coinnigh cárta cúltaca

Cláraigh dhá mhodh íocaíochta ar a laghad, go preferably ar dhá chuntas éagsúla. Is minic agus is costasaí an cás a chlúdaíonn sé seo: cuirtear cárta na cuideachta in ionad cárta eile, ní smaoiníonn aon duine ar an API a chur san áireamh ar an liosta síntiús le nuashonrú, agus stopann an tseirbhís trí seachtaine ina dhiaidh sin. Is féidir le híocaíocht theipthe (stádas FAILED) fionraí sealadach ar do chuid eochracha API a chruthú.

Monatóireacht ar dhátaí éaga

Seiceáil dátaí éaga do chártaí cláraithe go rialta. Nuashonraigh cártaí sula dtéann siad in éag chun aon cur isteach a sheachaint.

Foláirimh íocaíochta

Comhcheangail féachaint ar shonraisc (GET /invoices) le script foláirimh:

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

Comhtháthaigh le do bhonneagar

Fíorú uathoibrithe

Comhtháthaigh fíorú tréimhsiúil ar stádas íocaíochta i do mhonatóireacht:

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

Príomhphointí

  • Liostaíonn GET /v1/billing/teams/{teamId}/payment-method na cártaí cláraithe
  • Socraíonn POST /v1/billing/teams/{teamId}/payment-method/default an cárta réamhshocraithe
  • Glactar le cártaí Visa, Mastercard, AMEX, Discover, JCB, agus UnionPay
  • Ní ghlactar le cártaí Indiacha don API (ach oibríonn siad do grok.com)
  • Coinnigh dhá chárta cláraithe ar a laghad i gcónaí chun cur isteach a sheachaint
  • Déan monatóireacht ar stádasanna FAILED i do chuid sonraisc chun fadhbanna íocaíochta a bhrath