Messenger API

Всё, что панель умеет с подключённым аккаунтом Telegram, WhatsApp или Instagram, — через REST: один ключ, один формат ответа, по разделам.

Продажи и оплаты

Товары, заказы и оплаты внутри чат-ботов: Payme, Click, Telegram Stars или вручную.

Товары и платёжные шлюзы настраиваются в панели (Продажи). Заказ получает ссылку Payme / Click или — от бота — Telegram-инвойс; после оплаты контакт получает тег paid:{product}, срабатывают правила payment_ok, ваши вебхуки получают order.paid.

Base URL: https://chatvendor.net/api/v1 · каждый ответ {"success": true, "data": …}

GET /shop/products Products of the workspace (name, price, picture, category, stock) channels:read

Право: channels:read

Ответ 200

curl https://chatvendor.net/api/v1/shop/products \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

GET /shop/orders Orders (filters: status, peer_id, product_id, limit) channels:read

Право: channels:read

Ответ 200

curl https://chatvendor.net/api/v1/shop/orders \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

POST /shop/orders Create an order for a contact and get the Payme / Click pay link; send=true posts it into the chat (gateway=telegram: a bot invoice paid with Stars or a provider token) channels:write

Право: channels:write

Тело запроса (application/json)

channel_idstring

peer_idinteger

product_idinteger

gatewaystring: auto | payme | click | telegram | manual

sendboolean

textstring

promostring

Ответ 200

curl -X POST https://chatvendor.net/api/v1/shop/orders \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"
  -H "Content-Type: application/json" \
  -d '[]'

GET /shop/orders/{id} One order with its pay link channels:read

Право: channels:read

Параметры

idpath · integerобязательно

Order id

Ответ 200

curl https://chatvendor.net/api/v1/shop/orders/1 \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

POST /shop/orders/{id}/paid Mark an order paid by hand (fires payment_ok rules, tags, subscription clock) channels:write

Право: channels:write

Параметры

idpath · integerобязательно

Order id

Ответ 200

curl -X POST https://chatvendor.net/api/v1/shop/orders/1/paid \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"

POST /shop/orders/{id}/cancel Cancel a pending order or refund a paid one (revokes tags/access) channels:write

Право: channels:write

Параметры

idpath · integerобязательно

Order id

Ответ 200

curl -X POST https://chatvendor.net/api/v1/shop/orders/1/cancel \
  -H "Authorization: Bearer cv_live_xxxxxxxxxxxx"