> For the complete documentation index, see [llms.txt](https://piqpay.gitbook.io/merchant-integration/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://piqpay.gitbook.io/merchant-integration/h2h-host-to-host-integration/ars/payout-creation-withdrawal.md).

# Payout creation (withdrawal)

PIQPAY offers following payout methods for ARS: PMC\_S2P\_ACCOUNT. 

{% hint style="info" %}
In the DEV environment, you can test creating withdrawals using the PMC\_S2P\_ACCOUNT methods. 

You can also test receiving callbacks for withdrawals with the CREATED, COMPLETED, CANCELLED, EXPIRED status.
{% endhint %}

Send a POST request with the following body parameters.

**Request Body Fields**

**apiKey** (string) - the API key you created for your brand (the Secret Key is specified in the request header as Bearer token);

**amount** (object)  - the order amount, type: integer, and the order currency, type: string (example amount: 1000 ARS = 100000 minorAmount);

**paymentMethod** (string) - the order payment method (you can find a list of available methods in the "Methods: Order and Withdrawal" section);

**clientId** (string) - the unique user ID in your system;

**externalId** (string) - the unique order ID in your system;

**callbackUrl** (string, optional) - the URL to which callbacks (notifications) will be sent when an order is created and its status changes;

**requisites** (array) - the recipient's details for money transferring, as specified in the withdrawal form on your website by your client :

ACCOUNT\_NUMBER (CVU/CBU/alias) - the account number (22 symbols) or account alias,

LEGAL\_NAME - official name of your client.

After sending an API request to create a withdrawal, you will receive a response from our server (example below). Once your withdrawal request is paid, you will receive a callback with a COMPLETED status (see the "Callback" section).

If you get an error after sending an API request, please check it in the "[API error](/merchant-integration/additional-information/api-errors.md)" section.

\
**Example of a request to create a payout using the PMC\_S2P\_ACCOUNT method**

{% code overflow="wrap" %}

```json
POST https://eha.piqpay.codes/v1/payouts
Authorization: Bearer ${secretKey}

{
   "apiKey": "<API_KEY>",
   "externalId":"620116420g480948829612",
   "clientId":"sa0sf98g425612",
   "paymentMethod":"PMC_S2P_ACCOUNT",
   "amount":{"currency":"ARS","minorAmount":100000},
   "requisites":[
   {"instruction":"ACCOUNT_NUMBER","value":"0123456789012345678901"},
   {"instruction": "LEGAL_NAME", "value": "John Doe"}
   ]
}
```

{% endcode %}

<details>

<summary>Example response to a withdrawal request</summary>

{% code overflow="wrap" %}

```json
{
    "id": "7f683aa9-95b5-4439-880a-963e251f3d3c",
    "createdAt": "2026-05-15T08:33:42.637Z",
    "merchant": {
        "id": "8481fd2a-16f3-45cf-8eb0-7de1285d518a",
        "name": "NewNik",
        "picture": null
    },
    "store": {
        "id": "e44a507b-39e0-4630-8e6b-d1763e5a93d1",
        "name": "ARS",
        "country": "AR",
        "picture": null
    },
    "externalId": "000c451ddx1d6506084",
    "clientId": "017c92156d1xdd166768",
    "amount": {
        "minorAmount": 300000,
        "currency": "ARS"
    },
    "exchangedAmount": null,
    "requisites": [
        {
            "instruction": "ACCOUNT_NUMBER",
            "value": "0123456789012345678901"
        },
        {
            "instruction": "IDENTITY_NUMBER",
            "value": "35.123.456"
        }
    ],
    "paymentMethod": {
        "code": "PMC_S2P_ACCOUNT",
        "instructions": [
            "ACCOUNT_NUMBER",
            "LEGAL_NAME"
        ]
    },
    "readyForPaymentAt": null,
    "processingSince": "2026-05-15T08:33:42.757Z",
    "reason": null,
    "state": "PROCESSING",
    "settledAt": null,
    "assignedAt": null,
    "expiredAt": null,
    "redirectUrl": null,
    "failureUrl": null,
    "cancelUrl": null
}
```

{% endcode %}

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://piqpay.gitbook.io/merchant-integration/h2h-host-to-host-integration/ars/payout-creation-withdrawal.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.