> 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/php/sozdanie-ordera-depozit.md). # Создание ордера (депозит) Для создания ордера по валюте PHP доступны следующие методы: | Название | Метод | Режим работы | | -------- | ----------------- | ------------ | | Gcash | PMC\_S2P\_GCASH | redirect | | Maya | PMC\_S2P\_MAYA | redirect | | QRPh | PMC\_S2P\_QR\_PAY | redirect | {% hint style="info" %} В ДЕВ (тестовой) среде вы можете опробовать создание ордеров по методу PMC\_S2P\_GCASH, PMC\_S2P\_MAYA и PMC\_S2P\_QR\_PAY. Также вы можете протестировать получение коллбэков для ордеров по статусам CREATED, COMPLETED, CANCELLED, EXPIRED. {% endhint %} Для создания ордера по этому методу вам нужно отправить POST запрос, в теле которого указываются следующие параметры. **Описание полей запроса** **apiKey** - API ключ, который вы создали для своего бренда (Secret Key указывается в заголовке запроса); **amount** - сумму ордера и валюта ордера (пример суммы: 1000 PHP = 100000 minorAmount); **paymentMethod** - метод оплаты ордера (список доступных методов вы найдете в разделе "Методы: ордер и вывод"); **clientId** - уникальный идентификатор пользователя в вашей системе; **externalId** - уникальный идентификатор ордера в вашей системе; **callbackUrl** (не обязательное поле) - URL адрес, на который будут приходить коллбэки (оповещения) при создании ордера и изменении его статуса; **redirectUrl** (не обязательное поле) - ссылка, по которой будет перенаправлен ваш клиент после успешной оплаты ордера при нажатии кнопки на странице checkout; **failureUrl** (не обязательное поле) - ссылка, по которой будет перенаправлен ваш клиент в случае сбоя при оплаты ордера при нажатии кнопки на странице checkout; **cancelUrl** (не обязательное поле) - ссылка, по которой будет перенаправлен ваш клиент в случае отмены ордера при нажатии кнопки на странице checkout. После успешного создания ордера вы получите ответ на отправленный API запрос со ссылкой на страницу оплаты (ссылка находится в поле checkoutUrl). Вам нужно перенаправить своего клиента на эту страницу для оплаты ордера. Если после отправки API запроса вы получите ошибку, то обратитесь к разделу "[Ошибки](/merchant-integration/ru/dopolnitelnaya-informaciya/oshibki.md)". {% hint style="info" %} Для методов Gcash, Maya и QRph не доступна частичная оплата ордера. {% endhint %} **Пример запроса на создание ордера по методу PMC\_S2P\_GCASH** ```json POST https://eha.piqpay.codes/v1/orders Authorization: Bearer ${secretKey} { "apiKey": "", "amount": { "currency": "PHP", "minorAmount": 10000 }, "clientId": "123456789", "externalId": "123456789", "paymentMethod": "PMC_S2P_GCASH", "redirectUrl": "https://example.com/redirect", "failureUrl": "https://example.com/failure", "cancelUrl": "https://example.com/cancel", "callbackUrl": "https://example.com/callback" } ``` **Пример запроса на создание ордера по методу PMC\_S2P\_MAYA** ```json POST https://eha.piqpay.codes/v1/orders Authorization: Bearer ${secretKey} { "apiKey": "", "amount": { "currency": "PHP", "minorAmount": 10000 }, "clientId": "123456789", "externalId": "123456789", "paymentMethod": "PMC_S2P_MAYA", "redirectUrl": "https://example.com/redirect", "failureUrl": "https://example.com/failure", "cancelUrl": "https://example.com/cancel", "callbackUrl": "https://example.com/callback" } ``` **Пример запроса на создание ордера по методу PMC\_S2P\_QR\_PAY** ```json POST https://eha.piqpay.codes/v1/orders Authorization: Bearer ${secretKey} { "apiKey": "", "amount": { "currency": "PHP", "minorAmount": 10000 }, "clientId": "123456789", "externalId": "123456789", "paymentMethod": "PMC_S2P_QR_PAY", "redirectUrl": "https://example.com/redirect", "failureUrl": "https://example.com/failure", "cancelUrl": "https://example.com/cancel", "callbackUrl": "https://example.com/callback" } ```
Пример ответа на запрос создания ордера {% code overflow="wrap" %} ```json { "order": { "id": "5f44564e-7bc0-40bd-83ad-a8abf51eb577", "createdAt": "2026-06-22T13:36:26.062Z", "merchant": { "id": "f81d01a2-4cb0-4f32-8dcb-f45eacc6a6cd", "name": "Piqpay TEST", "picture": null }, "store": { "id": "69dcdf62-8c37-4e59-ae1d-4d91f39574a2", "name": "PHP", "country": "PH", "picture": null }, "externalId": "1c1c5957-c37c-4b36-a771-d92b7decd151", "clientId": "a5b371db-517a-4584-8b3e-abc9a1314c80", "amount": { "minorAmount": 50000, "currency": "PHP" }, "paymentFlow": "EXTERNAL", "paymentMethod": { "code": "PMC_S2P_GCASH", "instructions": [ "LEGAL_NAME", "USERNAME", "APP_SECRET" ] }, "institution": "GCASH_PH", "readyForPaymentAt": null, "processingSince": null, "reason": null, "state": "READY_FOR_PAYMENT", "expiringAt": "2026-06-22T13:41:26.062Z", "redirectUrl": "https://example.com/redirect", "failureUrl": "https://example.com/failure", "cancelUrl": "https://example.com/cancel", "paymentUrl": "https://checkout.swiftorderpro.com/P2069051893386911745", "paymentQr": null, "paymentDeepLinks": null, "paymentCountry": null, "checkoutUrl": "https://checkout.piqpay.com/5f44564e-7bc0-40bd-83ad-a8abf51eb577", "adjustment": null, "clientFlow": "EXTERNAL", "adjustedAt": null, "endClient": { "name": null, "account": null, "email": null, "phone": null, "institution": null, "billingAddress": null }, "receiptConfig": null, "cashbackAmount": null, "cashbackPercentage": null }, "services": null, "requisites": null } ``` {% endcode %}
--- # 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/php/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.