Sandbox и API-ключи

Используйте тестовые ключи в среде dev. Полный OpenAPI spec доступен на странице API Reference.

1. Получите API key

Зарегистрируйте мерчанта в личном кабинете или через POST /v1/merchants (admin). Ключи dev начинаются с pk_dev_ (read) и sk_dev_ (write).

2. Заголовки запроса

Authorization: Bearer <API_KEY>
X-Merchant-Id: <uuid мерчанта>

3. Пример: создать подписку (curl)

curl -X POST https://api.dev.paycalendar.ru/v1/subscriptions \
  -H "Authorization: Bearer sk_dev_YOUR_KEY" \
  -H "X-Merchant-Id: YOUR_MERCHANT_UUID" \
  -H "Content-Type: application/json" \
  -d '{
    "customerEmail": "client@example.com",
    "planId": "PLAN_UUID",
    "returnUrl": "https://example.com/return",
    "couponCode": "WELCOME10"
  }'

4. Пример: JavaScript (fetch)

const res = await fetch("https://api.dev.paycalendar.ru/v1/subscriptions", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk_dev_YOUR_KEY",
    "X-Merchant-Id": "YOUR_MERCHANT_UUID",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    customerEmail: "client@example.com",
    planId: "PLAN_UUID",
    returnUrl: "https://example.com/return",
    couponCode: "WELCOME10",
  }),
});

const data = await res.json();
console.log(data.checkoutUrl);

5. OpenAPI

Спецификация: https://api.dev.paycalendar.ru/v1/openapi.json (источник: packages/shared/openapi.yaml).