Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Maksutavat

Oppitunti 6 / 14 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Maksutapojen hallinta
  2. Maksutapojen tarkastelu
  3. Oletusmaksutavan asettaminen
  4. Hyväksytyt kortit
  5. Maksujen hallinnan parhaat käytännöt
  6. Integroi infrastruktuuriisi
  7. Keskeiset asiat

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-method luettelee rekisteröidyt kortit
  • POST /v1/billing/teams/{teamId}/payment-method/default asettaa 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