# IFrame order

## Description

This functionality allows you to create payments without accessing our API by embedding an 'iframe\` on your page.

## Parameters

The following parameters are available to manage the created order:

| Parameter   | Required | Description                                                                               |
| ----------- | -------- | ----------------------------------------------------------------------------------------- |
| apiKey      | NO       | Public part of the API key (used to sign payment webhooks)                                |
| theme       | NO       | Design theme (light/dark)                                                                 |
| lang        | NO       | Language (ru, en, kr, lv, lt, de, pl, tp, tr, ua, fi, fr, ee, jp, bg, gr, es, it, cn, bn) |
| OrderID     | YES      | Payment ID                                                                                |
| description | NO       | Payment description                                                                       |
| currency    | NO       | Coin payment                                                                              |
| network     | NO       | Payment network                                                                           |
| amount      | NO       | Amount to be paid                                                                         |
| email       | NO       | Payer's email (to be pre-filled)                                                          |

> In the section **"Integration" -> "Integration settings"** in your personal account, you can configure the parameters for silence to create an order
>
> For example, you can fill URL for sending webhooks

## Example

As an example, let's create an order with the following parameters

* Organization ID: `817f197e-3b00-4359-8298-6097aeb52c69`
* `apiKey: odz2fn1+JhC...8J0fac4TnT6jew==`
* `orderId: Payment #1234`
* `description: Some payment description`
* `currency: USDT`
* `network: ethereum`

> Order parameters are specified in `query`

As a result, we will get the following 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
```

> To insert data into `query`, it must be escaped. In JavaScript, this can be done using the `encodeURIComponent` function
>
> const apikeyId = encodeURIComponent('odz2fn1+JhC...8J0fac4TnT6jew==');

The final embed code will be as follows:

```html
<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>
```

> The `allow="clipboard-read; clipboard-write"` attribute is required so that your customers can copy the payment address by clicking the "Copy" button