> 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/ru/h2h-host-to-host-integraciya/egp/sozdanie-ordera-depozit.md). # Создание ордера (депозит) Для создания ордера по валюте EGP доступны следующие методы: | Название | Метод | Режим работы | | ------------- | ---------------- | ------------- | | Mobile Wallet | PMC\_S2P\_WALLET | H2H, redirect | {% hint style="info" %} В ДЕВ (тестовой) среде вы можете опробовать создание ордеров по методу PMC\_S2P\_WALLET. Также вы можете протестировать получение коллбэков для ордеров по статусам CREATED, COMPLETED, CANCELLED, EXPIRED. {% endhint %} Для создания ордера по этому методу вам нужно отправить POST запрос, в теле которого указываются следующие параметры. **Описание полей запроса** **apiKey** - API ключ, который вы создали для своего бренда (Secret Key указывается в заголовке запроса); **amount** - сумму ордера и валюта ордера (пример суммы: 1000 EGP = 100000 minorAmount); **paymentMethod** - метод оплаты ордера (список доступных методов вы найдете в разделе "Методы: ордер и вывод"); **clientId** - уникальный идентификатор пользователя в вашей системе; **externalId** - уникальный идентификатор ордера в вашей системе; **callbackUrl** (не обязательное поле) - URL адрес, на который будут приходить коллбэки (оповещения) при создании ордера и изменении его статуса; **redirectUrl** (не обязательное поле) - ссылка, по которой будет перенаправлен ваш клиент после успешной оплаты ордера при нажатии кнопки на странице checkout; **failureUrl** (не обязательное поле) - ссылка, по которой будет перенаправлен ваш клиент в случае сбоя при оплаты ордера при нажатии кнопки на странице checkout; **cancelUrl** (не обязательное поле) - ссылка, по которой будет перенаправлен ваш клиент в случае отмены ордера при нажатии кнопки на странице checkout; **clientInstitution** (не обязательное поле) - нвазвание “банка”/ приложения, реквизиты которого вы хотите получить для оплаты ордера (список доступных приложений вы найдете в разделе "Справочник банков"), **clientAccount** (не обязательное поле) - номер телефона клиента в национальном формате (для Египта начинается с 01); {% hint style="info" %} На странице checkout кнопка «Back to store» ведет: по ссылке из redirectUrl, если ордер успешный; по ссылке из поля cancelUrl, если ордер отменен самим пользователем или из бэкофиса; по ссылке из поля failureUrl, если возникла ошибка при создании ордера. На странице checkout кнопка «Exit» всегда ведет по ссылке из redirectUrl. Если поле redirectUrl не указано в запросе, то и кнопок «Back to store» и «Exit» не будет на странице checkout при любом статусе ордера. Если в теле ордера не указать поле redirectUrl, то и поля cancelUrl и failureUrl не нужно указывать. {% endhint %} После успешного создания ордера вы получите ответ на отправленный API запрос со ссылкой на страницу оплаты (ссылка находится в поле checkoutUrl). Вам нужно перенаправить своего клиента на эту страницу для оплаты ордера. Если после отправки API запроса вы получите ошибку, то обратитесь к разделу "[Ошибки](/merchant-integration/ru/dopolnitelnaya-informaciya/oshibki.md)". {% hint style="info" %} Кроме того, по методу WALLET в ответе на запрос создания ордера (при указания номер телефона в поле clientAccount) мы возвращаем реквизиты для оплаты (в поле requisites). Вы можете использовать эти реквизиты для отображения на своей стороне/сайте, чтобы не перенаправлять клиента на нашу страницу. {% endhint %} {% hint style="info" %} Для метода WALLET доступна частичная оплата ордера. {% endhint %} **Пример запроса на создание ордера по методу PMC\_S2P\_WALLET** ```json POST https://eha.piqpay.codes/v1/orders Authorization: Bearer ${secretKey} { "apiKey": "", "amount": { "currency": "EGP", "minorAmount": 50000 }, "paymentMethod": "PMC_S2P_WALLET", "clientId": "123456789", "externalId": "123456789", "redirectUrl": "https://example.com/redirect", "callbackUrl": "https://example.com/callback", "failureUrl": "https://example.com/failure", "cancelUrl": "https://example.com/cancel" } ```
Пример ответа на запрос создания ордера ```json { "order": { "id": "53a19f4d-7998-479b-8f0e-1dd96b7c8692", "createdAt": "2026-02-18T16:37:53.612Z", "merchant": { "id": "8481fd2a-16f3-45cf-8eb0-7de1285d518a", "name": "NewNik", "picture": null }, "store": { "id": "75b93c2e-a448-4255-81e5-aac7179b8a16", "name": "BDTSec", "country": "BD", "picture": null }, "externalId": "davf4fczf22cr754", "clientId": "ed4dvh43", "amount": { "minorAmount": 50000, "currency": "EGP" }, "paymentFlow": null, "paymentMethod": { "code": "PMC_S2P_WALLET", "instructions": [ "ACCOUNT_NUMBER", "LEGAL_NAME" ] }, "institution": null, "readyForPaymentAt": null, "processingSince": null, "reason": null, "state": "CREATED", "expiringAt": "2026-02-18T16:52:53.612Z", "redirectUrl": "https://example.com/redirect", "failureUrl": null, "cancelUrl": null, "paymentUrl": null, "paymentQr": null, "paymentDeepLinks": null, "paymentCountry": null, "checkoutUrl": "https://checkout.piqpay.codes/53a19f4d-7998-479b-8f0e-1dd96b7c8692", "adjustment": null, "clientFlow": null, "adjustedAt": null, "endClient": { "name": null, "account": null, "email": null, "phone": null, "institution": null, "billingAddress": null }, "receiptConfig": null }, "services": null, "requisites": null } ```
--- # 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/ru/h2h-host-to-host-integraciya/egp/sozdanie-ordera-depozit.md?ask= ``` 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.