# 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.apollopayment.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==');

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

```html
<iframe 
    allow="clipboard-read; clipboard-write"
    src="https://iframe-order.apollopayment.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"` необходим чтобы ваши клиенты могли скопировать адрес платежа нажатием кнопки "Скопировать"