Русский

IFrame ордер

Описание

Данный функционал позволяет создавать платежи без обращения к нашему API путем встраивания на своей странице iframe.

Параметры

Для управления создаваемым ордером доступны следующие параметры:

Параметр
Обязательный
Описание

apiKey

НЕТ

Публичная часть API-ключа (используется для подписи вебхуков о платеже)

theme

НЕТ

Тема оформления (light/dark)

lang

НЕТ

Язык (ru, en, kr, lv, lt, de, pl, tp, tr, ua, fi, fr, ee, jp, bg, gr, es, it, cn, bn)

orderId

ДА

Идентификатор платежа

description

НЕТ

Описание платежа

currency

НЕТ

Монета оплаты

network

НЕТ

Сеть оплаты

amount

НЕТ

Сумма к оплате

email

НЕТ

Почта плательщика (будет предзаполнена)

В разделе "Интеграция" -> "Настройки интеграции" в личном кабинете можете настроить параметры по умолчанию для создания ордера

Например, можете заполнить адреса для отправки вебхуков

Пример

В качестве примера создадим ордер со следующими параметрами

  • Идентификатор организации: 817f197e-3b00-4359-8298-6097aeb52c69

  • apiKey: odz2fn1+JhC...8J0fac4TnT6jew==

  • orderId: Payment #1234

  • description: Some payment description

  • currency: USDT

  • network: ethereum

Параметры ордера указываются в query

В результате получим следующий URL

https://iframe-order.onchainpay.io/817f197e-3b00-4359-8298-6097aeb52c69?
    apiKeyId=odz2fn1%2BJhC...8J0fac4TnT6jew%3D%3D&
    orderId=Payment%20%231234&
    description=Some%20payment%20description&
    currency=USDT&
    network=ethereum

Для вставки данных в query их необходимо экранировать. В JavaScript это можно сделать с помощью функции encodeURIComponent

const apikeyId = encodeURIComponent('odz2fn1+JhC...8J0fac4TnT6jew==');

Итоговый код для вставки будет следующим:

<iframe 
    allow="clipboard-read; clipboard-write"
    src="https://iframe-order.onchainpay.io/817f197e-3b00-4359-8298-6097aeb52c69?apiKeyId=odz2fn1%2BJhC...8J0fac4TnT6jew%3D%3D&orderId=Payment%20%231234&description=Some%20payment%20description&currency=USDT&network=ethereum"
></iframe>

Атрибут allow="clipboard-read; clipboard-write" необходим чтобы ваши клиенты могли скопировать адрес платежа нажатием кнопки "Скопировать"

Last updated