> For the complete documentation index, see [llms.txt](https://merch-int.moneyhoney.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://merch-int.moneyhoney.io/api/apellyacii/sozdanie-apellyacii.md).

# Создание апелляции

### Метод запроса <a href="#metod-zaprosa" id="metod-zaprosa"></a>

POST

### URL запроса <a href="#url-zaprosa" id="url-zaprosa"></a>

/v2/merchant/appeals

### Параметры запроса <a href="#parametry-zaprosa" id="parametry-zaprosa"></a>

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

<table><thead><tr><th width="177">Название</th><th width="166">Формат</th><th>Описание</th></tr></thead><tbody><tr><td>transactionId</td><td>int</td><td>Идентификатор транзакции.</td></tr><tr><td>amount</td><td>decimal</td><td>Сумма апелляции.</td></tr><tr><td>img (Опционально)</td><td>string (binary)</td><td>Изображения (формат png/jpg). Допустима загрузка нескольких изображений сразу (см. пример запроса).</td></tr><tr><td>imgPath (Опционально)</td><td>string</td><td>Ссылки на изображение или на сайт с изображением, к примеру можно использовать сервис <a href="https://gekkk.co/">https://gekkk.co/</a> или ему подобные (Формат png/jpg). Допустимо указание нескольких ссылок на изображения (см. пример запроса).</td></tr><tr><td>report<br>(Опционально)</td><td>string (binary)</td><td>Документ (формат pdf). Допустима загрузка нескольких файлов.</td></tr><tr><td>reportPath (Опционально)</td><td>string</td><td>Ссылки на документы на файлообменнике (Формат pdf). Допустимо указание нескольких ссылок.</td></tr><tr><td><p>video</p><p>(Опционально)</p></td><td>string (binary)</td><td>Видео (формат mp4). Допустима загрузка нескольких файлов.</td></tr><tr><td><p>videoPath</p><p>(Опционально)</p></td><td>string</td><td>Ссылки на видео (Формат mp4). Допустимо указание нескольких ссылок.</td></tr><tr><td>comment</td><td>string(0-255)</td><td>Комментарий.</td></tr></tbody></table>

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

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

```bash
curl --request POST \
  --url https://{{domain}}/v2/merchant/appeals \
  --header 'Authorization: Bearer {{your_api_token}}' \
  --header 'X-Signature: {{sign}}'
  --header 'Content-Type: multipart/form-data' \
  --form 'transactionId=101' \
  --form 'amount=10000' \
  --form 'img=@first-image.jpg;type=image/jpeg' \
  --form 'img=@second-image.jpg;type=image/jpeg' \
  --form 'imgPath=https://image-sharing.com/kz29j3Xe9U' \
  --form 'imgPath=https://image-sharing.com/imW963KeXP' \
  --form 'report=@receipt.pdf;type=application/pdf' \
  --form 'video=@recording.mp4;type=video/mp4' \
  --form 'comment='
```

{% endtab %}

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

<pre class="language-php"><code class="lang-php"><strong>$httpClient = new \GuzzleHttp\Client();
</strong>$response = $httpClient->post('https://{{domain}}/v2/merchant/appeals', [
    'headers' => [
        'Authorization' => 'Bearer {{your_api_token}}',
        'Content-Type'  => 'multipart/form-data'
    ],
    'multipart' => [
        [
            'name' => 'transactionId',
            'contents' => '101'
        ],
        [
            'name' => 'amount',
            'contents' => '10000'
        ],
        [
            'name' => 'img',
            'contents' => Psr7\Utils::tryFopen('first-image.jpg', 'r'),
            'filename' => 'first-image.jpg'
        ],
        [
            'name' => 'img',
            'contents' => Psr7\Utils::tryFopen('second-image.jpg', 'r'),
            'filename' => 'second-image.jpg'
        ],
        [
            'name' => 'imgPath',
            'contents' => 'https://image-sharing.com/kz29j3Xe9U'
        ],
        [
            'name' => 'imgPath',
            'contents' => 'https://image-sharing.com/imW963KeXP'
        ],
        [
            'name' => 'report',
            'contents' => Psr7\Utils::tryFopen('receipt.pdf', 'r'),
            'filename' => 'receipt.pdf'
        ],
        [
            'name' => 'video',
            'contents' => Psr7\Utils::tryFopen('recording.mp4', 'r'),
            'filename' => 'recording.mp4'
        ],
        [
            'name' => 'comment',
            'contents' => ''
        ]
    ]
]);
</code></pre>

{% endtab %}
{% endtabs %}

\*при формировании подписи для multipart/form-data, нужно подписывать только путь

### Параметры ответа <a href="#parametry-otveta" id="parametry-otveta"></a>

<table><thead><tr><th width="299">Название</th><th>Формат</th><th>Описание</th></tr></thead><tbody><tr><td>id</td><td>int</td><td>Идентификатор апелляции</td></tr><tr><td>status</td><td>string(1-255)</td><td>Статус апелляции(PENDING, SUCCESS, DECLINE, CANCEL)</td></tr></tbody></table>

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

```json
{
  "id": 333,
  "status": "PENDING"
}
```
