> 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/egp/payout-creation-withdrawal.md).

# Payout creation (withdrawal)

PIQPAY offers following payout methods for EGP: PMC\_S2P\_WALLET. 

{% hint style="info" %}
In the DEV environment, you can test creating withdrawals using the PMC\_S2P\_WALLET 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 EGP = 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 (string) - the phone number for sending funds in the national internal domestic format (starting with 01).

BANK\_NAME (string) - recipient's bank name for sending funds via the SBP method (more details in the "Bank Directory" section).

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\_WALLET 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_WALLET",
   "amount":{"currency":"EGP","minorAmount":100000},
   "requisites":[
    {"instruction":"ACCOUNT_NUMBER","value":"01112345678"},
    {"instruction":"BANK_NAME","value":"INSTAPAY"}]
}
```

{% endcode %}

<details>

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

{% code overflow="wrap" %}

```json
{"id": "f7d6d020-9e73-47a1-ahd737741",
    "createdAt": "2026-02-12T15:33:23.212Z",
    "merchant": {
        "id": "8481fd2a-16f3-45cf-8eb0-7de1285d518a",
        "name": "NewNik",
        "picture": null
    },
    "store": {
        "id": "d8440d52-25a5-4e8e-907d-3d73dd3763a8",
        "name": "Best",
        "country": "RU",
        "picture": null
    },
    "externalId": "62011639612",
    "clientId": "sa0s335612",
    "amount": {
        "minorAmount": 100000,
        "currency": "EGP"
    },
    "exchangedAmount": null,
    "requisites": [
        {
            "instruction": "ACCOUNT_NUMBER",
            "value": "01112345678"
        },
        {
            "instruction": "BANK_NAME",
            "value": "INSTAPAY"
        }
    ],
    "paymentMethod": {
        "code": "PMC_S2P_WALLET",
        "instructions": [
            "ACCOUNT_NUMBER",
            "LEGAL_NAME"
        ]
    },
    "readyForPaymentAt": null,
    "processingSince": "2026-02-12T15:33:23.346Z",
    "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/egp/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.