> For the complete documentation index, see [llms.txt](https://docs.payengine.co/payengine-api-v2.5/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payengine.co/payengine-api-v2.5/onboarding/transmit-to-processor-v2.md).

# Submit for Review

## Submit onboarding application for partners' review

<mark style="color:green;">`POST`</mark> `https://<Platform-host>/merchant/:id/submit`

Attempts to submit fully completed application to start the review process.

#### Path Parameters

<table><thead><tr><th width="209">Name</th><th width="250">Type</th><th>Description</th></tr></thead><tbody><tr><td>id<mark style="color:red;">*</mark></td><td>string</td><td>Merchant ID</td></tr></tbody></table>

#### Request Body

<table><thead><tr><th>Name</th><th width="210">Type</th><th>Description</th></tr></thead><tbody><tr><td>status</td><td>string</td><td>New Status</td></tr></tbody></table>

#### Response Body

<table><thead><tr><th width="206">Name</th><th width="134">Type</th><th>Description</th></tr></thead><tbody><tr><td>signing_url</td><td>string</td><td>Depending on the configuration in the partner portal, the link will either direct to a DocuSign page or to the merchant portal, where the docusign document can be viewed for signature</td></tr></tbody></table>

{% tabs %}
{% tab title="200 " %}
\
The link is typically rendered in an iframe which sends an event back to hosting app upon completion of the signing process.

```
{
    "message": "merchant updated",
    "data": {
        "id": "8dbf55c3-46c8-424d-817c-e14838c76ab4",
        "signing_url": <Digital Signature URL>
    }
}
```

{% endtab %}
{% endtabs %}

## Status Values

{% hint style="warning" %}
If your account has auto signature enabled then application is automatically submitted and signature link is provided in the response to initiate underwriting process.\
\
If your merchant decides not to sign the document or does not complete the process then the status of the application remain unchanged.
{% endhint %}

| Status            | Description                                            |
| ----------------- | ------------------------------------------------------ |
| in\_review        | Start the review process and notify appropriate admins |
| submitted\_to\_pe | Submit the application to Platform for onboarding     |
| editing           | Move application to editing phase                      |
| suspended         | Suspend merchant account                               |

{% hint style="info" %}
Webhook event: **MERCHANT\_STATUS\_CHANGED**
{% endhint %}

```javascript
{
  event_uid: '43ab1219e4eab0809528a211c115f099',
  event: 'MERCHANT_STATUS_CHANGED',
  data: {
    id: 'c404d923-226f-4aae-92da-22c1ef370434',
    signing_url: <Digital Signature URL>,
    account_id: 'e90c1de6-4e87-4c9e-bcbc-c535d6e349ec',
    merchant_id: 'c404d923-226f-4aae-92da-22c1ef370434'
  }
}
```