Documentation Help

Tilda Plugin

Setup Tilda

Step 1: Open Payment Settings

  1. Go to Site Settings in Tilda.

  2. Navigate to Payment Systems → Payment Services.

  3. Select Universal Payment System.

Step 2: Configure Payment System

  1. Choose New Payment System (for developers) as the settings template.

  2. Fill in the required fields:

    • LOGIN: Store ID from PlexyPay.

    • SECRET FOR ORDER SIGNATURE: Publishable API Key from PlexyPay.

    • SECRET FOR NOTIFICATION SENDING: Publishable API Key from PlexyPay.

    • CURRENCY: KZT.

    • COUNTRY: KZ.

    • LANGUAGE: Define the language code for the payment widget.

    • SUCCESS PAGE URL: Redirect URL for successful payments.

    • FAILURE PAGE URL: Redirect URL for failed payments.

Step 3: Advanced Settings

  • API URL: https://tilda.plexypay.com/api/v1/payments

  • TEST API URL: Leave empty.

Step 4: Field Mappings

Tilda Field

API Field

LOGIN

order[store_id]

CURRENCY

order[currency] (RUB/USD)

LANGUAGE

checkout[locale] (Uppercase)

COUNTRY

order[country] (Uppercase)

SUCCESS PAGE URL

checkout[success_url]

FAILURE PAGE URL

checkout[cancel_url]

TEST MODE

order[is_test]

NOTIFICATION URL

checkout[callback_url]

ORDER NUMBER

order[reference] (Format: <ProjectID>_<OrderID>)

ORDER DESCRIPTION

order[description] (Max: 1024 characters)

ORDER AMOUNT

order[amount] (In cents)

ORDER TIME

order[posted_at] (ISO-8601)

CUSTOMER EMAIL

customer[email]

CUSTOMER PHONE

customer[phone]

CUSTOMER NAME

customer[full_name]

SIGNATURE

signature

PRODUCTS

order[products] (JSON Array in Base64)

PRODUCT ID

id

PRODUCT

name

PRODUCT QUANTITY

quantity

PRODUCT PRICE

price (In cents)

PRODUCT FULL PRICE

fullPrice (In cents)

PRODUCT PHOTO

image

Step 5: Signature Generation

  • Signature Format:

    {{order[store_id]}}:{{order[currency]}}:{{order[amount]}}:{{secret}}

  • Hash Algorithm: MD5

  • HMAC Key: Use the secret as the algorithm key.

Step 6: Webhook Notifications

  • Success Indicator: code = 0

  • Transaction ID: UUID

  • Success Response:

    {"status":"ok"}

  • Error Response:

    {"status":"error"}

  • Response Format: JSON

Step 7: Save & Activate

  1. Ensure all fields are correctly filled.

  2. Click Save Changes.

  3. Start accepting payments via PlexyPay in Tilda.

For further assistance, contact PlexyPay Support.

Настройка Тильды

Шаг 1: Откройте настройки оплаты

  1. Войдите в Настройки сайта на Tilda.

  2. Перейдите в раздел Платёжные системы → Платёжные сервисы.

  3. Выберите Универсальная платёжная система.

Шаг 2: Настройка платёжной системы

  1. Выберите шаблон настроек Новая платёжная система (для разработчиков).

  2. Заполните обязательные поля:

    • LOGIN: ID магазина в PlexyPay.

    • SECRET FOR ORDER SIGNATURE: Публичный API-ключ PlexyPay.

    • SECRET FOR NOTIFICATION SENDING: Публичный API-ключ PlexyPay.

    • CURRENCY: KZT.

    • COUNTRY: KZ.

    • LANGUAGE: Код языка для виджета оплаты.

    • SUCCESS PAGE URL: URL для успешной оплаты.

    • FAILURE PAGE URL: URL при неудачной оплате.

Шаг 3: Расширенные настройки

  • API URL: https://tilda.plexypay.com/api/v1/payments

  • TEST API URL: Оставьте пустым.

Шаг 4: Соответствие полей

Поле Tilda

Поле API

LOGIN

order[store_id]

CURRENCY

order[currency] (RUB/USD)

LANGUAGE

checkout[locale] (в верхнем регистре)

COUNTRY

order[country] (в верхнем регистре)

SUCCESS PAGE URL

checkout[success_url]

FAILURE PAGE URL

checkout[cancel_url]

TEST MODE

order[is_test]

NOTIFICATION URL

checkout[callback_url]

ORDER NUMBER

order[reference] (формат: <ProjectID>_<OrderID>)

ORDER DESCRIPTION

order[description] (до 1024 символов)

ORDER AMOUNT

order[amount] (в центах)

ORDER TIME

order[posted_at] (формат ISO-8601)

CUSTOMER EMAIL

customer[email]

CUSTOMER PHONE

customer[phone]

CUSTOMER NAME

customer[full_name]

SIGNATURE

signature

PRODUCTS

order[products] (JSON-массив в Base64)

PRODUCT ID

id

PRODUCT

name

PRODUCT QUANTITY

quantity

PRODUCT PRICE

price (в центах)

PRODUCT FULL PRICE

fullPrice (в центах)

PRODUCT PHOTO

image

Шаг 5: Генерация подписи

  • Формат подписи:

{{order[store_id]}}:{{order[currency]}}:{{order[amount]}}:{{secret}}

  • Алгоритм хэширования: MD5

  • Ключ HMAC: используйте секретный ключ.

Шаг 6: Уведомления через вебхуки

  • Признак успеха: code = 0

  • ID транзакции: UUID

  • Ответ при успехе:

{"status":"ok"}

  • Ответ при ошибке:

{"status":"error"}

  • Формат ответа: JSON

Шаг 7: Сохранение и активация

  1. Проверьте, что все поля заполнены правильно.

  2. Нажмите Сохранить изменения.

  3. Начните принимать платежи через PlexyPay на Tilda. Если понадобится помощь, обращайтесь в службу поддержки PlexyPay.

26 August 2025
PluginsInsales Plugin