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" необходим чтобы ваши клиенты могли скопировать адрес платежа нажатием кнопки "Скопировать"