Modhanna Íocaíochta
Ar an leathanach seo
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-methodna cártaí cláraithe - Socraíonn
POST /v1/billing/teams/{teamId}/payment-method/defaultan 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