Зачем это нужно

Корзина — это одна платёжная ссылка Stripe на несколько ваших продуктов, у каждого своя цена и количество. Клиент открывает одну ссылку и видит все позиции сразу.

Используйте, когда клиент покупает комбинацию, а не один продукт:

• тариф собирается из частей — «базовый план + 2 места + 100 аккаунтов»;

• заказ из нескольких товаров, которые нужно оплатить одним платежом;

• AI-агент партнёра должен собрать такую ссылку по запросу клиента прямо в чате (через MCP — инструмент create_partner_stripe_cart_payment_link).

Два режима — выбираются автоматически по продуктам:

Смешивать разовые и подписочные продукты в одной ссылке нельзя, как и подписки с разным периодом (месяц + год), разные валюты или тестовые продукты вместе с боевыми — запрос вернёт INVALID_INPUT. Пробного периода у корзины нет: если нужен trial, выпускайте ссылку на один продукт.

Как подключиться

1. Возьмите API-ключ партнёра (мини-апп или ваш менеджер EasyPay). Нужно разрешение product_create — то же, что для создания продукта и платёжной ссылки.

2. Все продукты корзины должны быть уже одобрены командой заботы. Их stripe_product_id (prod_…) видны в мини-апп в карточках продуктов и в MCP-инструменте list_partner_live_stripe_payment_links.

Endpoint

POST https://api.appsign.me/create-partner-stripe-cart-payment-link
X-Partner-Api-Key: ваш-api-ключ
Content-Type: application/json

Формат запроса

{
  "items": [
    { "stripe_product_id": "prod_PLAN",     "unit_amount": 4900, "quantity": 1 },
    { "stripe_product_id": "prod_SEATS",    "unit_amount": 4900, "quantity": 2 },
    { "stripe_product_id": "prod_ACCOUNTS", "unit_amount": 1000, "quantity": 100 }
  ],
  "allow_promotion_codes": false,
  "success_url": "https://example.com/thanks",
  "client_token": "order-2417"
}

Что берётся из продуктов (передать нельзя): валюта, окружение (test/live), тип корзины и период подписки.

Формат ответа

HTTP-статус всегда 200 — смотрите поле success.

{
  "success": true,
  "payment_link_id": "plink_…",
  "short_url": "https://short.appsign.me/AbCdEf1234",
  "short_url_id": "…",
  "currency": "USD",
  "mode": "subscription",
  "interval": "month",
  "interval_count": 1,
  "line_item_count": 3,
  "items": [
    { "stripe_product_id": "prod_PLAN", "stripe_price_id": "price_…", "quantity": 1 },
    { "stripe_product_id": "prod_SEATS", "stripe_price_id": "price_…", "quantity": 2 },
    { "stripe_product_id": "prod_ACCOUNTS", "stripe_price_id": "price_…", "quantity": 100 }
  ],
  "duplicate": false
}

Клиенту отдавайте short_url. У разовой корзины mode = one_time, а interval и interval_count = null.

Повторы

• Та же корзина (те же продукты, цены, количества и опции) без client_token вернёт ту же ссылку с duplicate: true — случайный повтор не создаёт вторую ссылку.

• Нужна отдельная ссылка того же состава (например, второму клиенту) — передайте новый client_token.

• Тот же client_token с другой корзиной вернёт IDEMPOTENCY_KEY_REUSED_WITH_DIFFERENT_PAYLOAD.

• Состав выданной ссылки не редактируется: изменилось количество — создайте новую корзину.

Ошибки

Stripe cart: one payment link for several products (EN)

A cart is one Stripe payment link for several of your products, each with its own price and quantity. Use it when a customer buys a combination — "base plan + 2 seats + 100 accounts" — instead of sending several links. Via MCP the tool is create_partner_stripe_cart_payment_link.

The mode is derived from the products:

Mixing one-time and subscription products, subscriptions with different periods, different currencies, or test with live products returns INVALID_INPUT. Free trials are not available in a cart.

Endpoint: POST https://api.appsign.me/create-partner-stripe-cart-payment-link, header X-Partner-Api-Key, permission product_create. All products must be approved.

Request: items (1..20 of {stripe_product_id, unit_amount, quantity} — unit_amount is the price of ONE unit in cents, per period for subscriptions; quantity 1..999; one entry per product), optional currency (check only — always inherited), payment_method_types, allow_promotion_codes, success_url, client_token.

Response (HTTP 200, check success): short_url (share it with the customer), payment_link_id, currency, mode (one_time / subscription), interval, interval_count (null for one-time), line_item_count, items[] with stripe_price_id, duplicate.

Repeats: an identical cart returns the same link with duplicate: true; pass a new client_token to get a separate link with the same composition. An issued link can't be edited — create a new cart when quantities change.

Errors: INVALID_INPUT, PRODUCT_NOT_FOUND, PRODUCT_NOT_APPROVED, CROSS_TENANT_ATTEMPT, SHORT_URL_UNAVAILABLE (link created, short URL missing — contact support with your client_token), INTEGRATION_UPSTREAM_ERROR / INTEGRATION_TIMEOUT (Stripe failure — retry with a new client_token).