Maksutavat
Tällä sivulla
Maksutapojen hallinta
Management API:n avulla voit tarkistaa rekisteröidyt kortit ja määrittää oletusmaksutavan automaattisia veloituksia varten. Tämän hallinta on välttämätöntä, jotta vältyt palvelukatkoilta, jotka johtuvat epäonnistuneista maksuista.
Maksutapojen tarkastelu
Korttien hallinnalla API:n kautta on yksi käytännön tavoite, mutta se on kriittinen: havaitse vanhenemassa oleva kortti ennen kuin veloitus epäonnistuu. Epäonnistunut lasku ei ole vain eristynyt taloudellinen tapahtuma – se johtaa palvelun keskeytykseen, mikä on käytännössä tuotantokatko, jonka alkuperä on kirjanpidossa.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Vastaus sisältää tiedot jokaisesta kortista: tyypin (Visa, Mastercard jne.), viimeiset 4 numeroa, vanhenemispäivämäärän ja tilan (aktiivinen, oletus).
Oletusmaksutavan asettaminen
Vaihtaaksesi automaattisissa veloituksissa käytettävää korttia:
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 on tunnus, jonka saat näkymä-päätepisteestä. Muutos tulee voimaan tulevissa veloituksissa – ei niissä, jotka ovat jo käynnissä. Jos laskun tilaksi muuttuu FAILED, oletuskortin vaihtaminen ei yritä maksua automaattisesti uudelleen: korjaa ensin maksutapa ja tarkista sitten kyseisen laskun tila.
Hyväksytyt kortit
xAI hyväksyy laajan valikoiman maksukortteja API:n käyttöön:
- Visa
- Mastercard
- American Express (AMEX)
- Discover
- JCB
- UnionPay
Tärkeä rajoitus: Intialaiset kortit
Intiassa myönnettyjä maksukortteja ei hyväksytä xAI API:n käyttöön. Tämä rajoitus koskee vain API:a – kuluttajille tarkoitetun Grok-palvelun maksuihin (grok.comissa tai mobiilisovelluksissa) tämä rajoitus ei vaikuta.
Jos toimit Intiasta ja haluat käyttää API:a, sinun on käytettävä toisessa maassa myönnettyä korttia tai tutkittava muita maksuvaihtoehtoja.
Maksujen hallinnan parhaat käytännöt
Pidä varakortti mukana
Rekisteröi vähintään kaksi maksutapaa, mieluiten kahdelle eri tilille. Tämä kattaa yleisen ja kalliin skenaarion: yrityskortti vaihdetaan, kukaan ei muista lisätä API:a päivitettävien tilausten listalle, ja palvelu pysähtyy kolme viikkoa myöhemmin. Epäonnistunut maksu (tila FAILED) voi johtaa API-avainten väliaikaiseen keskeytykseen.
Valvo vanhenemispäiviä
Tarkista säännöllisesti rekisteröityjen korttiesi vanhenemispäivät. Päivitä kortit ennen niiden vanhenemista välttääksesi katkokset.
Maksuhälytykset
Yhdistä laskujen tarkastelu (GET /invoices) hälytyskomentosarjaan:
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!")
# Lähetä ilmoitus (sähköposti, Slack jne.)
Integroi infrastruktuuriisi
Automatisoitu varmennus
Integroi maksutilan säännöllinen varmennus valvontaasi:
# Kuukausittainen varmennuskomentosarja
#!/bin/bash
RESPONSE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/payment-method" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY")
# Tarkista, onko oletuskortti aktiivinen
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')
"
Keskeiset asiat
GET /v1/billing/teams/{teamId}/payment-methodluettelee rekisteröidyt kortitPOST /v1/billing/teams/{teamId}/payment-method/defaultasettaa oletuskortin- Visa-, Mastercard-, AMEX-, Discover-, JCB- ja UnionPay-kortit hyväksytään
- Intialaisia kortteja ei hyväksytä API:a varten (mutta ne toimivat osoitteessa grok.com)
- Pidä aina vähintään kaksi korttia rekisteröitynä katkosten välttämiseksi
- Valvo laskujesi FAILED-tiloja havaitaksesi maksuongelmat