1С-Битрикс → AgentPay · инструкция для магазина

1. Магазин в AgentPay

Войдите в /business, создайте магазин.
Коннектор: 1С-Битрикс.
Поле Webhook URL заказа укажите адрес вашего сайта:
```
https://shop.example.ru/bitrix/tools/agentpay/order_created.php
```
Сохраните три значения:
- API base — хост AgentPay API (на проде https://…)
- Merchant key — mk_… (один раз при создании или «Новый ключ API»)
- Store UUID — id магазина в таблице кабинета

2. Модуль на сайте

Скопируйте папку модуля в Битрикс:
```
bitrix/modules/agentpay/
```
Исходники: репозиторий AgentPay → integrations/bitrix/agentpay/.
Настройки → Модули → AgentPay → Установить. Нужны модули sale, catalog, iblock.

Настройки модуля AgentPay. Заполните:

Поле	Что вставить
API base	Корень API без слэша в конце
Merchant key	Ключ из кабинета /business
Store UUID	id магазина AgentPay
Webhook HMAC secret	Тот же секрет, что у магазина в AgentPay

Сохранить → кнопка Синхронизировать каталог.

3. Как понять, что работает

В /business таблица товаров = каталог Битрикса (SKU, цена, наличие).
Заказ агента создаёт заказ Sale. В описании заказа: AgentPay purchaseId=…. Адрес берётся из order.delivery.address.
Смена статуса в Sale уходит на
```
POST {API}/merchant/orders/{purchaseId}/status
```

Требования к каталогу

У товара должен быть стабильный артикул: XML_ID или CODE. Модуль мапит его в sku. Если оба пустые — bitrix-{element_id}.

Доставка

AgentPay передаёт адрес покупателя в свойства заказа Sale. Накладную перевозчика создаёт ваш модуль доставки в Битриксе. API перевозчика AgentPay не вызывает.

Чек продажи

Модуль кладёт order.customer.email в свойство EMAIL заказа. Ваш ОФД шлёт чек на эту почту, как при обычном заказе с сайта.

4. Возврат товара

Покупатель пишет вам по контактам поддержки магазина.
Отмените заказ в Sale. Ваш ОФД пробьёт чек возврата по правилам сайта.
Модуль отправит в AgentPay статус cancelled. AgentPay вернёт коины покупателю.

Частичный возврат позиций в AgentPay v1 не поддерживается. Подробнее: /legal/refunds, Merchant API · возвраты.

Поддержка: help@agentpay.shop. Все платформы.