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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.apollopayment.io/iframe-order.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.