Документация

Брендирование

Логотип, фирменный цвет и имя продавца на странице оплаты

Hosted Checkout и виджет показывают ваш логотип, имя и брендовый цвет. Настраивается за минуту в дашборде или через API.

Что настраивается

ПолеГде появляется
display_nameЗаголовок страницы оплаты, email-чек
logo_urlЛого слева от суммы на checkout, favicon
brand_colorКнопка «Открыть в Kaspi», прогресс-бар, акценты
support_emailСсылка «Связаться с продавцом» внизу страницы

Все поля опциональны. Без настройки страница покажет общее оформление Pay Bot.

Через дашборд

pay.aibot.kz/dashboard/branding — загрузите логотип, выберите цвет, сохраните. Изменения применяются мгновенно для всех новых открытий checkout. Уже открытые страницы клиентов обновятся при следующем polling.

Через API

bash
Скачать
curl -X PATCH https://payapi.aibot.kz/me/branding \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "Coffee Lab",
    "logo_url": "https://your-cdn.com/logo.svg",
    "brand_color": "#7c3aed",
    "support_email": "[email protected]"
  }'
python
Скачать
import requests
requests.patch(
    "https://payapi.aibot.kz/me/branding",
    headers={"Authorization": "Bearer YOUR_JWT"},
    json={
        "display_name": "Coffee Lab",
        "logo_url": "https://your-cdn.com/logo.svg",
        "brand_color": "#7c3aed",
        "support_email": "[email protected]",
    },
)
javascript
Скачать
await fetch("https://payapi.aibot.kz/me/branding", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_JWT",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    display_name: "Coffee Lab",
    logo_url: "https://your-cdn.com/logo.svg",
    brand_color: "#7c3aed",
    support_email: "[email protected]",
  }),
});
php
Скачать
$ch = curl_init("https://payapi.aibot.kz/me/branding");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "PATCH",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_JWT",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "display_name" => "Coffee Lab",
        "logo_url" => "https://your-cdn.com/logo.svg",
        "brand_color" => "#7c3aed",
        "support_email" => "[email protected]",
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
curl_exec($ch);

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

  • •Формат: SVG, PNG, JPG, WebP
  • •Размер файла: до 1 MB
  • •Рекомендуется: квадратный или горизонтальный SVG с прозрачным фоном
  • •Минимальная высота: 64px (для retina-дисплеев)
  • •Логотип масштабируется до 40px в высоту на checkout

Если файл не на вашем CDN, загрузите его через дашборд — Pay Bot положит на собственный S3 и вернёт logo_url.

Цвет

brand_color — hex с #, например #2d6a4f. Используется для:

  • •Цвета кнопки «Открыть в Kaspi»
  • •Спиннера ожидания и прогресс-индикатора
  • •Лёгкого фонового градиента в верхней части страницы

Pay Bot автоматически проверяет контраст текста — если ваш цвет слишком тёмный, текст останется белым; если светлый — переключится на тёмный.

Свой домен (Enterprise)

На тарифе Enterprise страница оплаты может работать на вашем поддомене:

code
https://pay.coffeelab.kz/checkout/{token}

Требуется DNS CNAME на pay.aibot.kz и сертификат Let's Encrypt — Pay Bot оформит автоматически. Обратитесь в поддержку, чтобы подключить.

Где видно брендинг

  • •Hosted Checkout — pay.aibot.kz/checkout/{token}
  • •POS-режим — ?display=1
  • •Модальное окно виджета
  • •Email-чек после оплаты (если включён)
  • •Подпись From: в test-webhook из дашборда

Что дальше