# ECommerce (Оплата товара)

{% hint style="info" %}
Суть метода: Оплата товара по ссылке
{% endhint %}

## Метод запроса

POST

## Url запроса

/api/v2/withdrawal/ecom

## Параметры запроса

На вход принимаются следующие параметры

Если какой либо из необязательных параметров не требуется для оплаты заявки, например login, password , то не передавайте его вовсе.

<table><thead><tr><th width="219">Название</th><th width="86" data-type="checkbox">Обяз.</th><th width="151">Формат</th><th>Описание</th><th data-hidden>Описание</th><th data-hidden>Формат</th><th data-hidden data-type="checkbox">Обязательно</th></tr></thead><tbody><tr><td>order_id</td><td>true</td><td>string(1-200)</td><td>Ваш уникальный номер заявки</td><td>Ваш уникальный номер заявки</td><td></td><td>false</td></tr><tr><td>site_account</td><td>true</td><td>string(1-255)</td><td>Код счета, с которого будет выполняться списание, например sber</td><td>Код счета, на который выполнять зачисление. Например sber</td><td></td><td>false</td></tr><tr><td>amount</td><td>true</td><td>string(1-255)</td><td>Сумма заявки</td><td>Сумма по заявке</td><td></td><td>false</td></tr><tr><td>account</td><td>true</td><td>string(1-255)</td><td><p>Ссылка на страницу оплаты/ товар который необходимо оплатить. Например: </p><pre class="language-postman_json"><code class="lang-postman_json">https://shop.ru/product/1
</code></pre></td><td></td><td></td><td>false</td></tr><tr><td>quantity</td><td>false</td><td>string(1-255)</td><td>Количество товара для покупки (при необходимости)</td><td></td><td></td><td>false</td></tr><tr><td>login</td><td>false</td><td>string(1-255)</td><td>Логин (при необходимости)</td><td></td><td></td><td>false</td></tr><tr><td>password</td><td>false</td><td>string(1-255)</td><td>Пароль (при необходимости)</td><td></td><td></td><td>false</td></tr><tr><td>full_name</td><td>false</td><td>string(1-255)</td><td>ФИО (при необходимости)</td><td></td><td></td><td>false</td></tr><tr><td>additional_instructions</td><td>false</td><td>string(1-255)</td><td>Дополнительные инструкции (при необходимости)</td><td></td><td></td><td>false</td></tr><tr><td>contact_telegram</td><td>false</td><td>string(1-255)</td><td>Контакт телеграмм для связи, при необходимости диалога или возникновения вопросов с процессом покупки (при необходимости)</td><td></td><td></td><td>false</td></tr><tr><td>contact_watsapp</td><td>false</td><td>string(1-255)</td><td>Контакт вацап для связи, при необходимости диалога или возникновения вопросов с процессом покупки (при необходимости)</td><td></td><td></td><td>false</td></tr><tr><td>notification_url</td><td>false</td><td>string(1-255)</td><td>Ссылка для отправки уведомления по этой транзакции</td><td></td><td></td><td>false</td></tr></tbody></table>

Пример запроса

{% tabs %}
{% tab title="CURL" %}

```sh
curl --request POST \
  --url https://{{your_api_domain}}/api/v2/withdrawal/ecom \
  --header 'Authorization: Bearer {{your_api_token}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": "500.00",
    "order_id": "OUT_2024_1289",
    "site_account": "sber",
    "account": "https://shop.ru/product/1",
    "quantity": "2",
    "additional_instructions": "цвет - красный",
    "contact_telegram": "@telegram",
    "contact_whatsapp": "875467812912515",
    "full_address": "Бутово 16",
    "login": "vasiii",
    "password": "123",
    "full_name": "Василий Победяев Средневич"
}'
```

{% endtab %}

{% tab title="PHP + Guzzle" %}

```php
$httpClient = new \GuzzleHttp\Client();
$response = $httpClient->post('https://{{your_api_domain}}/api/v2/withdrawal/ecom', [
    'json' => [
            "amount"=> "500.00",
            "order_id"=> "OUT_2024_1289",
            "site_account"=> "sber",  
            "account"=> "https://shop.ru/product/1",
            "quantity"=> "2",
            "additional_instructions"=> "цвет - красный",
            "contact_telegram"=> "@telegram",
            "contact_whatsapp"=> "875467812912515",
            "full_address"=> "Бутово 16",
            "login"=> "vasiii",
            "password"=> "123",
            "full_name"=> "Василий Победяев Средневич"
    ],
    'headers' => [
        'Authorization' => 'Bearer ' . $yourApiToken,
    ]
]);
```

{% endtab %}
{% endtabs %}

## Параметры ответа

<table><thead><tr><th width="180">Название</th><th width="151">Формат</th><th>Описание</th><th data-hidden>Описание</th><th data-hidden>Формат</th><th data-hidden data-type="checkbox">Обязательно</th></tr></thead><tbody><tr><td>id</td><td>number</td><td>Номер заявки в нашей системе</td><td>Код метода, в данном случае card</td><td></td><td>false</td></tr><tr><td>amount</td><td>string(1-255)</td><td>Сумма по заявке</td><td>Ваш уникальный номер заявки</td><td></td><td>false</td></tr><tr><td>commission</td><td>string(1-255)</td><td>Сумма комиссии по заявке</td><td>Сумма по заявке</td><td></td><td>false</td></tr></tbody></table>

#### Пример ответа

```
{
  "id": 20,
  "amount": "100.00",
  "commission": "2.00",
}
```


---

# 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://fkassa.gitbook.io/firekassa-api-v2/transactions/withdrawal/create/ecommerce-oplata-tovara.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.