Премини към основното съдържание
Български— Изберете език
Меню

Начини на плащане

Урок 6 от 14 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Управление на Вашите начини на плащане
  2. Преглед на начините на плащане
  3. Задаване на начин на плащане по подразбиране
  4. Приети карти
  5. Най-добри практики за управление на плащанията
  6. Интегриране във Вашата инфраструктура
  7. Ключови изводи

Управление на Вашите начини на плащане

API за управление Ви позволява да преглеждате регистрираните карти и да задавате картата по подразбиране за автоматични таксувания. Управлението на този процес е от съществено значение, за да се избегнат прекъсвания в услугата, причинени от неуспешни плащания.

Преглед на начините на плащане

Управлението на картите чрез API има една практическа, но критична цел: откриване на карта, която скоро изтича, преди таксуването да се провали. Неуспешната фактура не е просто изолиран финансов инцидент – тя води до спиране на услугата, което по същество представлява производствен срив, произтичащ от счетоводството.

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

Отговорът съдържа информация за всяка карта: тип (Visa, Mastercard и др.), последните 4 цифри, датата на валидност и статуса (активна, по подразбиране).

Задаване на начин на плащане по подразбиране

За да промените картата, използвана за автоматични таксувания:

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 е идентификаторът, върнат от крайната точка за преглед. Промяната влиза в сила за предстоящи таксувания, а не за тези, които вече са в процес на изпълнение. Ако статусът на фактура се промени на FAILED, смяната на картата по подразбиране не я преизпълнява автоматично: първо коригирайте начина на плащане, след което проверете статуса на засегнатата фактура.

Приети карти

xAI приема широк спектър от разплащателни карти за API:

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

Важно ограничение: Индийски карти

Разплащателни карти, издадени в Индия, не се приемат за използване на xAI API. Това ограничение важи само за API – плащанията за потребителската услуга Grok (чрез grok.com или мобилни приложения) не са засегнати от това ограничение.

Ако се намирате в Индия и искате да използвате API, трябва да използвате карта, издадена в друга държава, или да разгледате други опции за плащане.

Най-добри практики за управление на плащанията

Поддържайте резервна карта

Регистрирайте поне два начина на плащане, за предпочитане на два различни акаунта. Сценарият, който това покрива, е често срещан и скъп: корпоративната карта бива подменена, никой не се сеща да включи API в списъка с абонаменти за актуализиране и услугата спира три седмици по-късно. Неуспешното плащане (статус FAILED) може да доведе до временно спиране на Вашите API ключове.

Следете сроковете на валидност

Редовно проверявайте датите на валидност на Вашите регистрирани карти. Актуализирайте картите преди изтичането им, за да избегнете всякакво прекъсване.

Известия за плащания

Комбинирайте прегледа на фактури (GET /invoices) със скрипт за известяване:

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

Интегриране във Вашата инфраструктура

Автоматизирана проверка

Интегрирайте периодична проверка на статуса на плащанията във Вашия мониторинг:

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

Ключови изводи

  • GET /v1/billing/teams/{teamId}/payment-method изброява регистрираните карти
  • POST /v1/billing/teams/{teamId}/payment-method/default задава картата по подразбиране
  • Приети са карти Visa, Mastercard, AMEX, Discover, JCB и UnionPay
  • Индийските карти не се приемат за API (но работят за grok.com)
  • Винаги поддържайте поне две регистрирани карти, за да избегнете прекъсвания
  • Следете статусите FAILED във Вашите фактури, за да откриете проблеми с плащанията