> 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/pkr/sozdanie-ordera-depozit.md). # Создание ордера (депозит) Для создания ордера по валюте PKR доступны следующие методы: | Название | Метод | Режим работы | | --------- | ------------------- | ------------ | | JAZZCCASH | PMC\_S2P\_JAZZCCASH | redirect | | EASYPAISA | PMC\_S2P\_EASYPAISA | redirect | | Raast QR | PMC\_S2P\_QR\_PAY | H2Р | {% hint style="info" %} В ДЕВ (тестовой) среде вы можете опробовать создание ордеров по методу PMC\_S2P\_JAZZCCASH и PMC\_S2P\_EASYPAISA. Также вы можете протестировать получение коллбэков для ордеров по статусам CREATED, COMPLETED, CANCELLED, EXPIRED. {% endhint %} Для создания ордера по этому методу вам нужно отправить POST запрос, в теле которого указываются следующие параметры. **Описание полей запроса** **apiKey** - API ключ, который вы создали для своего бренда (Secret Key указывается в заголовке запроса); **amount** - сумму ордера и валюта ордера (пример суммы: 1000 PKR = 100000 minorAmount); **paymentMethod** - метод оплаты ордера (список доступных методов вы найдете в разделе "Методы: ордер и вывод"); **clientId** - уникальный идентификатор пользователя в вашей системе; **externalId** - уникальный идентификатор ордера в вашей системе; **clientAccount** - номер телефона клиента в национальном формате (начинается с 03); **callbackUrl** (не обязательное поле) - URL адрес, на который будут приходить коллбэки (оповещения) при создании ордера и изменении его статуса; **redirectUrl** (не обязательное поле) - ссылка, по которой будет перенаправлен ваш клиент после успешной оплаты ордера при нажатии кнопки на странице checkout; **failureUrl** (не обязательное поле) - ссылка, по которой будет перенаправлен ваш клиент в случае сбоя при оплаты ордера при нажатии кнопки на странице checkout; **cancelUrl** (не обязательное поле) - ссылка, по которой будет перенаправлен ваш клиент в случае отмены ордера при нажатии кнопки на странице checkout. {% 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" %} Если вы создаете ордер по депозиту PKR и передали номер телефона клиента в поле clientAccount, то вам не нужно перенаправлять клиента на страницу checkoutUrl; просто ожидайте коллбэк о статусе ордера. {% endhint %} {% hint style="info" %} Для методов JAZZCASH, EASYPAISA и Raast QR не доступна частичная оплата ордера. {% endhint %} **Пример запроса на создание ордера по методу PMC\_S2P\_JAZZCASH** ```json POST https://eha.piqpay.codes/v1/orders Authorization: Bearer ${secretKey} { "apiKey": "", "amount": { "currency": "PKR", "minorAmount": 50000 }, "paymentMethod": "PMC_S2P_JAZZCASH", "clientId": "123456789", "externalId": "123456789", "clientAccount": "03006298786", "redirectUrl": "https://example.com/redirect", "callbackUrl": "https://example.com/callback", "failureUrl": "https://example.com/failure", "cancelUrl": "https://example.com/cancel" } ``` **Пример запроса на создание ордера по методу PMC\_S2P\_EASYPAISA** ```json POST https://eha.piqpay.codes/v1/orders Authorization: Bearer ${secretKey} { "apiKey": "", "amount": { "currency": "PKR", "minorAmount": 50000 }, "paymentMethod": "PMC_S2P_EASYPAISA", "clientId": "123456789", "externalId": "123456789", "clientAccount": "03006298786", "redirectUrl": "https://example.com/redirect", "callbackUrl": "https://example.com/callback", "failureUrl": "https://example.com/failure", "cancelUrl": "https://example.com/cancel" } ``` **Пример запроса на создание ордера по методу PMC\_S2P\_QR\_PAY** ```json POST https://eha.piqpay.codes/v1/orders Authorization: Bearer ${secretKey} { "apiKey": "", "amount": { "currency": "PKR", "minorAmount": 50000 }, "paymentMethod": "PMC_S2P_QR_PAY", "clientId": "123456789", "externalId": "123456789", "clientAccount": "03006298786", "redirectUrl": "https://example.com/redirect", "callbackUrl": "https://example.com/callback", "failureUrl": "https://example.com/failure", "cancelUrl": "https://example.com/cancel" } ```
Пример ответа на запрос создания ордера ```json {"order": { "id": "714213c5-54ca-4412-98d1-060896baf17b", "createdAt": "2026-02-19T08:07:50.643Z", "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": "davvc4dc2ftаf4ffc5аssв3jrc1cdk", "clientId": "4d331ccdс712fccаfsff4ав5cr2", "amount": { "minorAmount": 50000, "currency": "PKR" }, "paymentFlow": null, "paymentMethod": { "code": "PMC_S2P_JAZZCASH", "instructions": [ "USERNAME", "ACCOUNT_NUMBER", "PASSWORD", "APP_SECRET" ] }, "institution": null, "readyForPaymentAt": null, "processingSince": null, "reason": null, "state": "CREATED", "expiringAt": "2026-02-19T08:12:50.643Z", "redirectUrl": "https://cb.dev.acqproject.com/api/piqpay", "failureUrl": null, "cancelUrl": null, "paymentUrl": null, "paymentQr": null, "paymentDeepLinks": null, "paymentCountry": null, "checkoutUrl": "https://checkout.piqpay.codes/714213c5-54ca-4412-98d1-060896baf17b", "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/pkr/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.