Для интеграции с платёжной системой запросите логин и пароль для тестового сервера
\nВойдите в панель управления (админка), на странице настройки находится ваш апи ключ.
\nЗапросите ip платёжной системы для добавления в ваш вайтлист.
\nДля отладки рекомендуем пользоваться данной коллекцией постман.
\nСваггер pay-guru.io/api/swagger
\nНа тестовом сервере для вас создана полноценная тестовая среда, ничем не отличающаяся от прод сервера.
\nВ разделе Приём, вы видите все ваши сделки на приём, в разделе Выплаты, ваши сделки на выплату. В Спорах, созданные вами в телеграм боте или по апи споры
\nНа странице сделки вы можете изменить её статус, выполнить или отменить, и изменить её сумму (приём)
\nНа странице сделки есть кнопка Дебаг, которая открывает страницу, со списоком всех запросов, ответов, колбеков данной сделки.
\nВ админке вы можете скачать список сделок с их текущими состояниями, и различные отчёты в xlsx.
\nОбщее:
\nСделка - сделка на приём или выплату, если нет уточнения
\nСтатус сделок: created/success/cancelled
\nПри изменении статуса сделки или изменении суммы сделки вы получаете колбек.
\nБАНКИ.
\nСделайте маппинг нужных вам банков. Актуальный список банков находится по адресу /api/external/banks/items
\nСДЕЛКИ НА ПРИЁМ. Вторичный трафик.
\nВторичный трафик обязательно должен сопровождаться достоверными и уникальными идентификаторами ваших пользователей. Далее id пользователя, в теле запроса передаётся в user.id. Эти id нужны только для того чтобы различать ваших пользователей. Вы должны передать id пользователя, если у вас есть возможность.
\nКак сделать user.id для запроса
\nuser.id пользователя это строка. user.id не может меняться. user.id может быть зашифрован. Всем будет удобнее, если в качестве user.id будет использован номер вашего пользователя “123456789”. В случае, если у вас нет номера пользователя, можете запросить у мерчанта и использовать другие уникальные, или хотя бы близкие к уникальности данные: емейл, телефон, ФИО, их компиляцию или шифрованную компиляцию.
\nСоздание сделок для пользователя
\nПокупатель не может одновременно производить множество платежей. Соответственно, для каждого пользователя (user.id) не может быть более одной сделки в состоянии created. Это значит, что перед созданием новой сделки, текущая открытая сделка данного пользователя должна быть отменена, если она у него имеется. Вы можете отменить открытую сделку методом cancel или эта сделка будет отменена автоматически при запросе новой сделки.
\nСДЕЛКИ НА ПРИЁМ. Первичный трафик.
\nЕсли у вас нет id пользователя, и нет данных для создании скомпилированного id пользователя, то вы можете создать сделку без user.id. При запросе сделки без id пользователя, считается, что она поступила от уникального пользователя, это позволяет вам, и пользователю, иметь множество одновременно выполняющихся идентичных сделок. Запросы на создание сделки без user.id не будут отклонены по причине наличия сделки на данную сумму. Но если пользователь создаёт одновременно множество сделок, тем более на одинаковую сумму, то при п2п обработке это может привести к отклонению запроса по причине недостатка свободных реквизитов.
\nВозможные изменения статуса сделок:
\nПС отменяет сделку в created
\nМерчант отменяет сделку по апи в created
\nПС выполняет сделку в created и в cancelled
\nПС выполняет сделку при принятии диспута в cancelled (приём)
\nПС отменяет сделку при принятии диспута в success (выплата)
\nИзменение суммы сделки
\nПо запросу мерчанта, а также в процессе обработки спора, ПС может изменить сумму сделки.
\nПри изменении суммы сделки отправляется колбек
\nКаждое изменение суммы фиксируется и возвращается при запросе статуса сделки в виде массива:
\n\"amountChangeHistory\": [\n{\n \"oldAmount\": 2938,\n \"newAmount\": 2948,\n \"newAmountUSDT\": 30.88,\n \"newFee\": 12.36,\n \"created\": \"2024-10-01T06:01:23.023Z\",\n \"source\": 0\n}\n]\n\nСумма сделки может изменится в любом состоянии сделки created/success/cancelled
\nСумма сделки может меняться многократно.
\nПараметры, которые меняются при изменении суммы сделки, и отражают текущее состояние: amount, amountUSDT, fee. Курс остаётся прежним.
\nЗАГОЛОВКИ
\nContent-Type: application/json
\nAuthorization: апи ключ
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"8847455","collectionId":"6ab90f4a-d543-4554-afe4-32e5d71d5969","publishedId":"2sAY4vg2Vt","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-03-24T05:53:43.000Z"},"item":[{"name":"Deal (IN)","item":[{"name":"create","id":"f767bdbd-52f1-4d5f-9687-7aa78c29175e","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"method\": 1,\r\n \"amount\": {{randomAmount}},\r\n \"currency\": \"RUB\",\r\n \"locale\": \"RU\",\r\n \"orderId\": \"any-order-number-1\",\r\n \"dealSuccessRedirectUrl\": \"https://merchant-site.com/success\",\r\n \"dealFailedRedirectUrl\": \"https://merchant-site.com/failed\",\r\n \"callbackUrl\": \"https://webhook.site/86856809-c92a-4715-9afc-bb45e81617ed\",\r\n \"user\": {\r\n \"id\": \"55\",\r\n \"createdAt\": \"{{randomDateInPast}}\",\r\n \"account\": \"A111222333\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/dealIn/create","description":"amount (number, required): The amount for the deal in.
currency (string, optional): currency for amount. See currencies/items for get list of supported currencies. Default value = RUB.
locale (string, required) - payment page localization (RU,EN,KZ,KG,UZ,AZ,TR,PT,ES)
method (number, optional) - the payment method for the deal in (0: card, 1: phone(SBP), 2: account number, 3:QR code, 4:Link). Default value = 0
bank (number, optional) - add this field only if you need to provide payment in a specific bank. See banks/items for get list of banks
sendersBank (number, optional) - specify sender's bank. Used to provide smartlink for a proper bank. See banks/items for get list of banks.
sendersName (string, optional) - specify sender's name.
paymentSystem (number, optional) - payment system for choosing requisites (0 - any, 1 - HUMO, 2 - UzCard, 3- Papara, 4 - Havale)
dealSuccessRedirectUrl (string, optional) - redirect URL in case of successful deal.
dealFailedRedirectUrl (string, optional) - redirect URL in case of failed deal in.
comment (string, optional) - any additional comments for the deal in.
callbackUrl (string, optional) - absolute callback Url (http/https) for deal status changes. Default value: callbackUrl from merchant settings.
orderId (string, optional, max length=128) - merchant order id
receiverCurrency (string array, optional) - array of currencies ONLY for cross-border deals. If specified - the deal is created as cross-border deal. Must contain currencies (RUB/TJS/UZS/AZN/...) for accepting deal.
user (object, optional) - merchant user details (all fields optional):
id (number or string, max 128 chars), $randomUUID used ONLY FOR DEMO
\ntrustLevel (number, 0...1)
\nkyc (bool)
\ncreatedAt (date/time, UTC)
\npurchasesSuccessCount (number, >=0)
\npurchasesCancelledCount (number, >=0)
\npurchasesAmount (number, >=0)
\nlastPurchaseTime (date/time, UTC)
\nfirstPurchaseTime (date/time, UTC)
\nmostUsedIP (string, max 36 chars)
\nmostUsedFingerprint (string, max 128 chars)
\naccount (string, max 256 chars) - user account in given payment system or bank
\ncustomerCardBin (string, optional) - BIN for customer card. if customerCardBin passed in request and paymentSystem!=0 - it must belong to the same payment system, otherwise the transaction will not be created and an error will be returned.
expired (datetime, optional) - deal will valid until specified date/time (ISO 8601 format, example (UTC): 2025-06-30T04:10:07Z)
sendersName (string, optional) - specify sender's name
onBackPressedUrl (string, optional) - absolute url to \"Back\" button on payment page
Optional fields is not available by default, ask fields provision
\nstate (string) - created/success/cancelled
amountUSDT - amount of deal in USDT
amount - amount in deal currency
fee (number) - gateway's fee of deal in USDT
paymentUrl (string) - absolute Url for payment page
id (string) - unique deal id
rate (number) - deal currency to USDT rate
to (string, optional) - card number, phone or card account number, link to QR-code or link to payment url (depend from method property)
bank (number, optional) - bank id (see /banks/items method), only for method=1 (phone)
bankName (string) - bank name (see /banks/items method), only for method=1 (phone)
holderName (string, optional) - name of bank account holder
bik (string, optional): bank BIK, only for method=1 (phone)
orderId (string, optional) - merchant order id
paymentSystem (number) - payment system for deal (0 - any, 1 - HUMO, 2 - UzCard)
customerCardBin (string, optional) - only if passed in request
expired (datetime, optional) - deal will valid until specified date/time (ISO 8601 format, example (UTC): 2025-06-30T04:10:07Z)
amountRequested (number, optional) - ONLY if the randomization mode is enabled AND the amount of the created transaction differs from the requested one
receiverCurrency (string[], optional) - receiver currencies, if they were requested when creating the deal
smartLink (string) - link for fast access to bank application. smartLink generated for sendersBank (if specified), otherwise - for bank
from (string, optional) - sender's masked data
deepLinks (string[], optional) - deep links for deal
onBackPressedUrl (string, optional) - absolute url to \"Back\" button on payment page
Example 1:
\n{\n \"state\": \"created\",\n \"amountUSDT\": 100,\n \"amount\": 10000,\n \"fee\": 4.9,\n \"rate\": 100,\n \"paymentUrl\": \"https://pay-guru.io/operation/9fcf4a8d-c415-42b7-ab0e-a75ecec7c9d0\",\n \"id\": \"9fcf4a8d-c415-42b7-ab0e-a75ecec7c9d0\",\n \"to\": \"6111111111111444\",\n \"bik\": \"044525974\" \n \"bank\": 0,\n \"bankName\": \"СберБанк\",\n \"holderName\": \"Иванов Иван Иванович\",\n \"orderId\": \"orderId\",\n \"paymentSystem\": 0,\n \"expired\": \"2025-06-30T04:10:07Z\",\n \"user\": {\n \"id\": \"55\",\n \"account\": \"A111222333\"\n },\n \"amountRequested\": 10003,\n \"receiverCurrency\": [\"TJS\"],\n \"smartLink\": \"https:// .... \"\n}\n\nproperty to and holderName - optional
Example 2:
\n{\n \"state\": \"created\",\n \"amountUSDT\": 100,\n \"amount\": 10000,\n \"fee\": 4.9,\n \"rate\": 100,\n \"paymentUrl\": \"https://pay-guru.io/operation/9fcf4a8d-c415-42b7-ab0e-a75ecec7c9d0\",\n \"id\": \"9fcf4a8d-c415-42b7-ab0e-a75ecec7c9d0\",\n \"to\": \"6111111111111444\",\n \"bik\": \"044525974\" \n \"bank\": 0,\n \"bankName\": \"СберБанк\",\n \"holderName\": \"Иванов Иван Иванович\",\n \"orderId\": \"orderId\",\n \"paymentSystem\": 1,\n \"customerCardBin\": \"986031\",\n \"expired\": \"2025-06-30T04:10:07Z\",\n \"smartLink\": \"https:// .... \"\n}\n\npaymentSystem==1 (HUMO) and customerCardBin passed in request and belong HUMO.
Example 3 (if receiverCurrency passed in request):
\n{\n \"state\": \"created\",\n \"amountUSDT\": 100,\n \"amount\": 10000,\n \"fee\": 4.9,\n \"rate\": 100,\n \"paymentUrl\": \"https://pay-guru.io/operation/9fcf4a8d-c415-42b7-ab0e-a75ecec7c9d0\",\n \"id\": \"9fcf4a8d-c415-42b7-ab0e-a75ecec7c9d0\",\n \"to\": \"6111111111111444\",\n \"bik\": \"044525974\"\n \"bank\": 0,\n \"bankName\": \"СберБанк\",\n \"holderName\": \"Иванов Иван Иванович\",\n \"orderId\": \"orderId\",\n \"receiverCurrency\": [\"TJS\", \"UZS\"],\n \"expired\": \"2025-06-30T04:10:07Z\",\n \"smartLink\": \"https:// .... \"\n}\n\nIf can't create deal or parameters error.
\n{\n \"type\": \"dealIn\",\n \"item\": see dealIn/status response\n}\n\nNo body
\nHTTP 200 if OK
\nHTTP 400 if deal not found
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}},"urlObject":{"path":["api","external","dealIn","6ae3f6ac-612c-4034-830a-253dccce5e45","cancel"],"host":["https://test.pay-guru.io"],"query":[],"variable":[]}},"response":[],"_postman_id":"8992e589-8918-4306-bd12-c4ff708f6552"},{"name":"items","id":"ac0ebf0b-2df2-43d4-8906-30a5ad4592b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/dealIn/items?count=100","description":"Return array of deals, see status method for each item.
optional, default 1000
\n","type":"text/plain"},"key":"count","value":"100"}],"variable":[]}},"response":[],"_postman_id":"ac0ebf0b-2df2-43d4-8906-30a5ad4592b5"},{"name":"items (from/to/count)","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"id":"7d992c36-4a31-4347-8131-e18b88b014d1"}}],"id":"5593def5-19df-4fd9-a759-b69b2a6c9db4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/dealIn/items?count=10&states=cancelled","description":"Return array of deals, see status method for each item.
optional
\n","type":"text/plain"},"key":"from","value":"2024-08-17T13:00:00Z"},{"disabled":true,"description":{"content":"optional
\n","type":"text/plain"},"key":"to","value":"2024-08-18T13:00:00Z"},{"description":{"content":"optional, default 1000
\n","type":"text/plain"},"key":"count","value":"10"},{"description":{"content":"optional, default ALL states (created,executing,cancelled,stopped,success)
\n","type":"text/plain"},"key":"states","value":"cancelled"}],"variable":[]}},"response":[],"_postman_id":"5593def5-19df-4fd9-a759-b69b2a6c9db4"},{"name":"status","id":"a6c79e01-ae8a-456b-b1eb-774399099bb1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/dealIn/b1b920ac-9825-4c1b-bedb-cf0c5481331a","description":"HTTP 200:
\nid (string) - deal id
state (string) - created/success/cancelled
method (number) - The payment method for the deal in (0: card, 1: phone(SBP), 2: account number, 3: QR-code, 4: Link)
amount - amount of deal, given currency. Can be changed (see amountChangeHistory property)
amountUSDT - amount of deal, USDT
locale (string, required) - payment page localization (RU,EN,KZ,KG,UZ,AZ,TR,PT,ES)
currency (string, optional) - currency for amount. See currencies/items for get list of supported currencies. Default value = RUB.
fee (number) - gateway's fee of deal, USDT
rate (number) - deal currency to USDT rate
to (string, optional) - card number, phone, account number, link to QR-code or link to payment url (depend from method property)
bank (number) - bank id (see /banks/items method)
bankName (string) - bank name (see /banks/items method)
bik (string) - bank BIK
holderName (string, optional) - name of bank account holder
paymentUrl (string) - absolute Url for payment page
created: (string) - UTC date/time deal creation date
updated (string) - UTC date/time of deal last status changes
files (string[]) - attached file ids
cancelReason (string, optional) - only for cancelled state (timeout - deal expired, newdeal - new deal created for user.id, trader - cancelled by trader)
orderId (string, optional) - merchant order id
paymentSystem (number) - payment system for deal (0 - any, 1 - HUMO, 2 - UzCard, 3 - Papara, 4 - Havale)
customerCardBin (string, optional) - only if passed to dealIn/create
expired (datetime) - deal will valid until specified date/time (ISO 8601 format, example (UTC): 2025-06-30T04:10:07Z)
amountRequested (number, optional) - ONLY if the randomization mode is enabled AND the amount of the created transaction differs from the requested one
amountInitial (number, optional) - deal amount at creation, present only if the amount was changed
receiverCurrency (string[], optional) - receiver currencies, if they were requested when creating the deal
from (string, optional) - sender's masked data
deepLinks (string[], optional) - deep links for deal
onBackPressedUrl (string, optional) - absolute url to \"Back\" button on payment page
Example 1:
\n{\n \"id\": \"9fcf4a8d-c415-42b7-ab0e-a75ecec7c9d0\",\n \"state\": \"created\",\n \"method\": 0,\n \"userId\": \"merchant-external-user-4224422\",\n \"amount\": 2948,\n \"amountUSDT\": 30.88,\n \"currency\": \"RUB\",\n \"orderId\": \"orderId\",\n \"fee\": 12.36,\n \"rate\": 94.3,\n \"to\": \"6111111111111444\", \n \"bank\": 0,\n \"bankName\": \"СберБанк\",\n \"holderName\": \"Иванов Иван Иванович\",\n \"paymentUrl\": \"https://pay-guru.io/operation/9fcf4a8d-c415-42b7-ab0e-a75ecec7c9d0\",\n \"created\": \"2024-08-15T09:14:07.348Z\",\n \"updated\": \"2024-08-15T09:14:07.348Z\",\n \"files\": [],\n \"amountChangeHistory\": [\n {\n \"oldAmount\": 2938,\n \"newAmount\": 2948,\n \"newAmountUSDT\": 30.88,\n \"newFee\": 12.36,\n \"created\": \"2024-10-01T06:01:23.023Z\",\n \"source\": 0\n }\n ],\n \"paymentSystem\": 1,\n \"customerCardBin\": \"986031\",\n \"expired\": \"2025-06-30T04:10:07Z\",\n \"amountInitial\": 2938,\n \"amountRequested\": 1001\n}\n\nproperty to and holderName - optional
amountChangeHistory (optional) returned only if deal amount was changed.source is action initiator (0 - merchant, 1 - gateway)customerCardBin - present only if passed in request
Example 2 (if receiverCurrency passed in request):
\n{\n \"id\": \"9fcf4a8d-c415-42b7-ab0e-a75ecec7c9d0\",\n \"state\": \"created\",\n \"method\": 0,\n \"userId\": \"merchant-external-user-4224422\",\n \"amount\": 2948,\n \"amountUSDT\": 30.88,\n \"currency\": \"RUB\",\n \"orderId\": \"orderId\",\n \"fee\": 4.9,\n \"rate\": 94.3,\n \"to\": \"6111111111111444\",\n \"bank\": 0,\n \"bankName\": \"СберБанк\",\n \"holderName\": \"Иванов Иван Иванович\",\n \"paymentUrl\": \"https://pay-guru.io/operation/9fcf4a8d-c415-42b7-ab0e-a75ecec7c9d0\",\n \"created\": \"2024-08-15T09:14:07.348Z\",\n \"updated\": \"2024-08-15T09:14:07.348Z\",\n \"files\": [],\n \"amountChangeHistory\": [\n {\n \"oldAmount\": 2938,\n \"newAmount\": 2948,\n \"newAmountUSDT\": 30.88,\n \"newFee\": 12.36,\n \"created\": \"2024-10-01T06:01:23.023Z\",\n \"source\": 0\n }\n ],\n \"amountInitial\": 2938,\n \"receiverCurrency\": [\"TJS\", \"UZS\"],\n \"expired\": \"2025-06-30T04:10:07Z\"\n}\n\nHTTP 400 (+error details):
\nIf can't found deal or parameters error.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}},"urlObject":{"path":["api","external","dealIn","b1b920ac-9825-4c1b-bedb-cf0c5481331a"],"host":["https://test.pay-guru.io"],"query":[],"variable":[]}},"response":[],"_postman_id":"a6c79e01-ae8a-456b-b1eb-774399099bb1"}],"id":"2592318f-e2ad-47bf-8112-5c4ca749bf4c","event":[{"listen":"prerequest","script":{"type":"text/javascript","packages":{},"exec":[""],"id":"9d2f1d82-3124-481d-869e-a2e0bb367347"}},{"listen":"test","script":{"type":"text/javascript","packages":{},"exec":[""],"id":"fa04a3b1-5a2c-489e-a38b-abafa723dbdf"}}],"_postman_id":"2592318f-e2ad-47bf-8112-5c4ca749bf4c","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}}},{"name":"Deal (ECOM)","item":[{"name":"create","id":"05f73791-5090-4f75-a639-1a76f1c60e32","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"amount\": {{randomAmount}},\r\n \"currency\": \"RUB\",\r\n \"orderId\": \"any-order-number-1\",\r\n \"comment\": \"some comment\",\r\n \"locale\": \"RU\",\r\n \"dealSuccessRedirectUrl\": \"https://merchant-site.com/success\",\r\n \"dealFailedRedirectUrl\": \"https://merchant-site.com/failed\",\r\n \"callbackUrl\": \"https://webhook.site/86856809-c92a-4715-9afc-bb45e81617ed\",\r\n \"user\": {\r\n \"id\": \"dfbe397e-d197-4632-918f-2b4dd76720f6\",\r\n \"email\": \"ivan.ivanov@gmail.com\"\r\n },\r\n \"card\": {\r\n \"ean\":\"1111222233334444\",\r\n \"cvv\": \"123\",\r\n \"expirationMonth\": 12,\r\n \"expirationYear\": 30,\r\n \"holder\": \"Ivan Ivanov\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/ecom/dealIn/create","description":"amount (number, required): The amount for the deal in.
currency (string, optional): currency for amount. See currencies/items for get list of supported currencies. Default value = RUB.
dealSuccessRedirectUrl (string, optional): The redirect URL in case of successful deal.
locale (string, required) - payment page localization (RU,EN,KZ,KG,UZ,AZ,TR,PT,ES)
dealFailedRedirectUrl (string, optional): The redirect URL in case of failed deal in.
comment (string, optional): Any additional comments for the deal in.
callbackUrl (string, optional): absolute callback Url (http/https) for deal status changes. Default value: callbackUrl from merchant settings.
orderId (string, optional, max length=128) - merchant order id
user (object, optional): The merchant user details:
email (string, optional) - customer emailcard (object, required) - card information - all properties required and expirationMonth/year must be in the future:
ean (string) - card number, only digits
\ncvv (string) - card CVV, 3 digits
\nexpirationMonth (number) - 1...12
\nexpirationYear (number) - two digits
\nholder (string) - card holder
\nOptional fields is not available by default, ask fields provision
\nstate (string): created/success/cancelled
amountUSDT amount of deal in USDT
amount - amount in deal currency
fee (number): gateway's fee of deal in USDT
paymentUrl (string): absolute Url for payment page
id (string): unique deal id
rate (number) deal currency to USDT rate
orderId (string, optional) - merchant order id
redirectUrl (string, optional) - 3DS check url
Example:
\n{\n \"id\": \"1cfe00a6-8981-47ed-b8ac-6adcda788df4\",\n \"state\": \"created\",\n \"amount\": 366.71,\n \"amountUSDT\": 3.67,\n \"fee\": 1.47,\n \"rate\": 100,\n \"orderId\": \"O1-7610727141410458\",\n \"expired\": \"2025-08-18T09:29:50.771Z\",\n \"paymentUrl\": \"https://dev.pay-guru.io/debug/ecom-dealin/1cfe00a6-8981-47ed-b8ac-6adcda788df4\"\n}\n\nIf can't create deal or parameters error.
\n{\n \"type\": \"dealInEC\",\n \"item\": see ecom/dealIn/status response\n}\n\nReturn array of deals, see status method for each item.
optional, default 1000
\n","type":"text/plain"},"key":"count","value":"100"}],"variable":[]}},"response":[],"_postman_id":"11d66ca0-c694-45c4-9f4a-c7743e62b625"},{"name":"items (from/to/count)","event":[{"listen":"test","script":{"id":"7d992c36-4a31-4347-8131-e18b88b014d1","exec":[""],"type":"text/javascript","packages":{}}}],"id":"24860aa2-a020-47ef-b2a3-32506a80cf8d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/ecom/dealIn/items?count=10&states=cancelled","description":"Return array of deals, see status method for each item.
optional
\n","type":"text/plain"},"key":"from","value":"2024-08-17T13:00:00Z"},{"disabled":true,"description":{"content":"optional
\n","type":"text/plain"},"key":"to","value":"2024-08-18T13:00:00Z"},{"description":{"content":"optional, default 1000
\n","type":"text/plain"},"key":"count","value":"10"},{"description":{"content":"optional, default ALL states (created,executing,cancelled,stopped,success)
\n","type":"text/plain"},"key":"states","value":"cancelled"}],"variable":[]}},"response":[],"_postman_id":"24860aa2-a020-47ef-b2a3-32506a80cf8d"},{"name":"status","id":"8b26d82d-7347-4bb0-ba50-c8a12c7438e1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/ecom/dealIn/1cfe00a6-8981-47ed-b8ac-6adcda788df4","description":"HTTP 200:
\nid (string): deal id
state (string): created/success/cancelled
amount amount of deal, given currency. Can be changed (see amountChangeHistory property)
amountUSDT amount of deal, usdt
locale (string, required) - payment page localization (RU,EN,KZ,KG,UZ,AZ,TR,PT,ES)
currency (string, optional): currency for amount. See currencies/items for get list of supported currencies. Default value = RUB.
fee (number): gateway's fee of deal, USDT
rate (number) deal currency to USDT rate
paymentUrl (string): absolute Url for payment page
created: (string): UTC date/time deal creation date
updated (string): UTC date/time of deal last status changes
cancelReason (string, optional) - only for cancelled state (timeout - deal expired, newdeal - new deal created for user.id, trader - cancelled by trader)
orderId (string, optional) - merchant order id
expired (datetime) - deal will valid until specified date/time (ISO 8601 format, example (UTC): 2025-06-30T04:10:07Z)
Example 1:
\n{\n \"id\": \"1cfe00a6-8981-47ed-b8ac-6adcda788df4\",\n \"state\": \"success\",\n \"method\": 0,\n \"amount\": 366.71,\n \"amountUSDT\": 3.67,\n \"locale\": \"EN\",\n \"currency\": \"RUB\",\n \"fee\": 1.47,\n \"rate\": 100,\n \"paymentUrl\": \"https://dev.pay-guru.io/debug/ecom-dealin/1cfe00a6-8981-47ed-b8ac-6adcda788df4\",\n \"created\": \"2025-08-18T09:14:50.856Z\",\n \"updated\": \"2025-08-18T09:15:02.008Z\",\n \"orderId\": \"O1-7610727141410458\",\n \"expired\": \"2025-08-18T09:29:50.771Z\"\n}\n\nHTTP 400 (+error details):
\nIf can't found deal or parameters error.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}},"urlObject":{"path":["api","external","ecom","dealIn","1cfe00a6-8981-47ed-b8ac-6adcda788df4"],"host":["https://test.pay-guru.io"],"query":[],"variable":[]}},"response":[],"_postman_id":"8b26d82d-7347-4bb0-ba50-c8a12c7438e1"}],"id":"fa46fb5f-8d78-4deb-a0cf-488232b94e15","event":[{"listen":"prerequest","script":{"type":"text/javascript","packages":{},"exec":[""],"id":"9d2f1d82-3124-481d-869e-a2e0bb367347"}},{"listen":"test","script":{"type":"text/javascript","packages":{},"exec":[""],"id":"fa04a3b1-5a2c-489e-a38b-abafa723dbdf"}}],"_postman_id":"fa46fb5f-8d78-4deb-a0cf-488232b94e15","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}}},{"name":"Deal (OUT)","item":[{"name":"create","id":"d62228b6-a95b-4ce2-842e-a838878ec61f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"method\": 1,\r\n \"amount\": {{randomAmount}},\r\n \"currency\": \"RUB\",\r\n \"locale\": \"RU\",\r\n \"to\": \"{{randomPhoneNumber}}\",\r\n \"orderId\": \"some-order-number-1\",\r\n \"callbackUrl\": \"https://webhook.site/82f342cc-9ff1-4a32-bf70-8af10daca1a8\",\r\n \"bank\": 0,\r\n \"receiverName\": \"Ivanov Ivan\",\r\n \"user\": {\r\n \"id\": \"0e4e359c-1c96-4708-b302-b181b12fdb93\",\r\n \"createdAt\": \"{{randomDateInPast}}\",\r\n \"account\": \"A111222333\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/dealOut/create","description":"method (number, optional) - the payment method for the deal in (0 - card, 1 - Phone(SBP), 2 - card account). Default value = 0
amount (number, required) - the amount for the deal in.
currency (string, optional) - currency for amount. See currencies/items for get list of supported currencies. Default value = RUB.
to (string) - card number of phone (depend from method property)
bank (number, required for methods 1 and 2): Bank id from method banks/items
paymentSystem (number, optional) - payment system for choosing requisites (0 - any, 1 - HUMO, 2 - UzCard, 3- Papara, 4 - Havale)
comment (string, optional) - any additional comments for the deal in.
callbackUrl (string, optional) - callback absolute Url (http/https) for deal status changes. Default value: callbackUrl from merchant settings.
orderId (string, optional, max length=128) - merchant order id
receiverName (string, optional, max length=128) - receiver name
user (object, optional) - the merchant user details (all fields optional):
id (number or string, max 128 chars), $randomUUID used ONLY FOR DEMO
\ntrustLevel (number, 0...1)
\nkyc (bool)
\ncreatedAt (date/time, UTC)
\npurchasesSuccessCount (number, >=0)
\npurchasesCancelledCount (number, >=0)
\npurchasesAmount (number, >=0)
\nlastPurchaseTime (date/time, UTC)
\nfirstPurchaseTime (date/time, UTC)
\nmostUsedIP (string, max 36 chars)
\nmostUsedFingerprint (string, max 128 chars)
\naccount (string, max 256 chars) - user account in given payment system or bank
\nexpirationDate (string, optional) - target card expiration date (\"mm/yy\" format), allowed only for method==0).
expired (datetime, optional) - deal will valid until specified date/time (ISO 8601 format, example (UTC): 2025-06-30T04:10:07Z)
Example 1 (deal out by phone number & bank)
\n{\n \"method\": 1,\n \"amount\": 1350,\n \"currency\": \"RUB\",\n \"to\": \"79451111234\",\n \"orderId\": \"order-147921\",\n \"callbackUrl\": \"https://webhook.site/82f342cc-9ff1-4a32-bf70-8af10daca1a8\",\n \"bank\": 0,\n \"expired\": \"2025-06-30T04:10:07Z\",\n \"user\": {\n \"id\": \"55\",\n \"account\": \"A111222333\"\n }\n}\n\nExample 2 (including expirationDate & paymentSystem):
\n{\n \"method\": 0,\n \"amount\": 2700,\n \"currency\": \"RUB\",\n \"to\": \"2222111133334444\",\n \"orderId\": \"order-457832\",\n \"callbackUrl\": \"https://webhook.site/82f342cc-9ff1-4a32-bf70-8af10daca1a8\",\n \"paymentSystem\": 2,\n \"expirationDate\": \"12/33\",\n \"expired\": \"2025-06-30T04:10:07Z\"\n}\n\nHTTP 200:
\nid (string) - unique deal id
state (string) - created
amountUSDT (number) - amount of deal in USDT
fee(number) - gateway's fee of deal, in USDT
rate (number) - deal currency to USDT rate
bank (int, optional) - bank id frombanks/items
bankName (string, optional) - bank name frombanks/items
orderId (string, optional) - merchant order id
paymentSystem (number) - payment system for deal (0 - any, 1 - HUMO, 2 - UzCard)
expired (datetime) - deal will valid until specified date/time (ISO 8601 format, example (UTC): 2025-06-30T04:10:07Z)
Example 1:
\n{\n \"amount\": 10000,\n \"amountUSDT\": 100,\n \"currency\": \"RUB\",\n \"fee\": 4.9,\n \"rate\": 100,\n \"state\": \"created\",\n \"id\": \"342380ff-0dc7-4b7e-b151-80941ac291da\",\n \"orderId\": \"orderId\",\n \"bank\": 10,\n \"bankName\": \"Ренессанс\",\n \"paymentSystem\": 0,\n \"expired\": \"2025-06-30T04:10:07Z\"\n}\n\nHTTP 400 (+error details):
\nIf can't create deal or parameters error.
\n{\n \"type\": \"dealOut\",\n \"item\": see dealOut/status response\n}\n\nReturn array of deals, see status method for each item.
optional, default 1000
\n","type":"text/plain"},"key":"count","value":"100"},{"disabled":true,"key":"states","value":"success"}],"variable":[]}},"response":[],"_postman_id":"04abb876-26f3-4ed7-904a-36c119e1145b"},{"name":"items (from/to/count)","event":[{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"id":"51017857-930f-4e60-bdb3-7dc3f81c84dc"}}],"id":"eb2df6ab-37b0-4d96-9d26-59b00d6d1e66","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/dealOut/items?from=2024-04-22T13:00:00Z&count=10&states=success","description":"Return array of deals, see status method for each item.
optional
\n","type":"text/plain"},"key":"from","value":"2024-04-22T13:00:00Z"},{"disabled":true,"description":{"content":"optional
\n","type":"text/plain"},"key":"to","value":"2024-05-23T13:00:00Z"},{"description":{"content":"optional, default 1000
\n","type":"text/plain"},"key":"count","value":"10"},{"description":{"content":"optional, default ALL states (created,success,cancelled)
\n","type":"text/plain"},"key":"states","value":"success"}],"variable":[]}},"response":[],"_postman_id":"eb2df6ab-37b0-4d96-9d26-59b00d6d1e66"},{"name":"status","id":"c3dd5e43-38d4-44f9-acb7-ff2fe0cbdc59","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/dealOut/284e9615-1386-45e9-a76f-54a2e526bbfb","description":"HTTP 200:
\nid(string): deal id
state (string): created/success/cancelled
method (number): The payment method for the deal in (0 - card, 1 - Phone(SBP), 2 - card account)
amount - amount in deal currency
amountUSDT - amount in currency and USDT
currency (string) - currency for amount. See currencies/items for get list of supported currencies. Default value = RUB.
fee (number) - gateway's fee of deal, USDT
rate (number) - deal currency to USDT rate
to (string) - card number, phone or card account (depend from method property)
bank (number, only for method=1) - bank for use with SBP (see /banks/items method)
bankName (string, optional) - bank name, only for method=1
paymentSystem (number, optional) - payment system for deal (0 - any, 1 - HUMO, 2 - UzCard, 3 - Papara, 4 - Havale)
created (string) - UTC date/time deal creation date
updated (string) - UTC date/time of deal last status change
files (string[]) - attached file ids
cancelReason (string, optional) - only for cancelled state (timeout - deal expired, newdeal - new deal created for user.id, trader - cancelled by trader)
orderId (string, optional) - merchant order id
expirationDate (string, optional) - target card expiration date (\"mm/yy\" format), only if passed in dealOut/create request.
expired (datetime) - deal will valid until specified date/time (ISO 8601 format, example (UTC): 2025-06-30T04:10:07Z)
{\n \"id\": \"fc4bf130-cf4b-41e7-9155-d3bb8d477ee1\",\n \"state\": \"success\",\n \"method\": 1,\n \"amount\": 10000,\n \"amountUSDT\": 100,\n \"currency\": \"RUB\",\n \"fee\": 4.9,\n \"rate\": 95.77,\n \"to\": \"79111111111\"\n \"bank\": 0,\n \"bankName\": \"Сбербанк\",\n \"orderId\": \"orderId\",\n \"updated\": \"2024-08-13T14:28:38.681Z\",\n \"created\": \"2024-08-13T14:28:33.277Z\",\n \"files\": [],\n \"paymentSystem\": 0,\n \"expirationDate\": \"09/27\",\n \"expired\": \"2025-06-30T04:10:07Z\"\n}\n\nHTTP 400 (+error details):
\nIf can't found deal or parameters error.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}},"urlObject":{"path":["api","external","dealOut","284e9615-1386-45e9-a76f-54a2e526bbfb"],"host":["https://test.pay-guru.io"],"query":[],"variable":[]}},"response":[],"_postman_id":"c3dd5e43-38d4-44f9-acb7-ff2fe0cbdc59"}],"id":"d3c34845-cef6-4322-93a7-96c5492a5b7e","event":[{"listen":"prerequest","script":{"type":"text/javascript","packages":{},"exec":[""],"id":"acb0d40b-98fc-4359-843e-f07da31d7f62"}},{"listen":"test","script":{"type":"text/javascript","packages":{},"exec":[""],"id":"dc759eb3-8c55-4ad8-9cad-0b9e92ff999c"}}],"_postman_id":"d3c34845-cef6-4322-93a7-96c5492a5b7e","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}}},{"name":"Disputes","item":[{"name":"create","id":"ebb18f84-e4b9-43fb-984b-dcd782fcc416","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"dealId\": \"aa9d0f95-d85f-4537-a4b5-efab66032240\",\r\n \"merchantDisputeId\": \"dispute-123\",\r\n \"requestedDealAmount\": 5258,\r\n \"files\": [{\r\n \"body\":\"MzQyMzgwZmYtMGRjNy00YjdlLWIxNTEtODA5NDFhYzI5MWRhc2QgbGtmYWxzZGZrIGFsZiBhbHNrZGpmIGxhc2pmZGxhcyBqZGZsYXNqZGYgbGFqc2RmIA==\",\r\n \"contentType\": \"application/pdf\"\r\n }]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/disputes/create","description":"dealId (string, required): id of deal
merchantDisputeId (string, optional): id of dispute in merchant system
requestedDealAmount (number, optional): requested deal amount in deal currency, by default equal to current deal amount
files (array of {contentType:string, body: string}, required) - array of files for dispute. body - base64 encoded file content, contentType - file content type (application/pdf, image/jpeg, ...). Array must not be empty.
disputeId (string): dispute id
merchantDisputeId (string): dispute id in merchant system
dealId (string): deal id for dispute
disputeNumber (number): dispute number
dealDisputesCounter (number): dispute number for deal, started from 1
state (string): current dispute state (open/accepted/rejected)
direction (number), 0 for inbound deals, 1 for outbound deals
currency(string): deal currency, see currencies/items for get list of supported currencies
requestedDealAmount (number): requested by merchant deal amount
created (string): dispute creation date/time (UTC, ISO-8601)
expired (string): dispute expiration date/time (UTC, ISO-8601)
merchantFiles (string[]): relative urls of attached files from merchant
initialDealAmount (number): deal amount at dispute creation time
initialDealAmountUSDT (number): deal amount in USDT at dispute creation time
{\n \"disputeId\": \"3e1ee86f-e338-4f52-af91-6f2863583dc4\",\n \"disputeNumber\": 132,\n \"dealDisputesCounter\": 1,\n \"dealId\": \"60f8d692-95fd-47ed-9530-8db31a7d5379\",\n \"merchantDisputeId\": \"dispute-123\"\n \"state\": \"open\",\n \"direction\": 0,\n \"currency\": \"RUB\",\n \"requestedDealAmount\": 4000,\n \"initialDealAmount\": 2000,\n \"initialDealAmountUSDT\": 20,\n \"created\": \"2025-10-21T11:39:06.160Z\",\n \"expired\": \"2025-10-21T14:39:06.160Z\",\n \"merchantFiles\": [\n \"/static/files/1cd4d645-74e1-4585-81d4-1e6e25ca0d2f.pdf\"\n ]\n}\n\n{\n \"type\": \"dispute\",\n \"item\": see disputes/status response\n}\n\nHTTP 200:
\ndisputeId (string): dispute id
dealId (string): deal id for dispute
merchantDisputeId (string): dispute id in merchant system
state (string): current dispute state (open/accepted/rejected)
direction (number): 0 for inbound deals, 1 for outbound deals
disputeNumber (number): dispute number
dealDisputesCounter (number): dispute number for deal, started from 1
requestedDealAmount (number): requested by merchant deal amount
acceptedDealAmount (number): accepted deal amount, given currency
acceptedDealAmountUSDT(number): accepted deal amount, USDT
currency(string): deal currency, see currencies/items for get list of supported currencies
created (datetime, UTC): dispute created date/time (UTC, ISO-8601)
updated (datetime, UTC): dispute created date/time (UTC, ISO-8601)
expired (string): dispute expiration date/time (UTC, ISO-8601)
merchantFiles (string[]): relative urls of attached files from merchant
traderFiles (string[]): relative urls of attached files from trader
initialDealAmount (number): deal amount at dispute creation time
initialDealAmountUSDT (number): deal amount in USDT at dispute creation time
{\n \"disputeId\": \"3e1ee86f-e338-4f52-af91-6f2863583dc4\",\n \"dealId\": \"60f8d692-95fd-47ed-9530-8db31a7d5379\",\n \"merchantDisputeId\": \"dispute-123\",\n \"dealDisputesCounter\": 1,\n \"disputeNumber\": 123,\n \"state\": \"open\",\n \"direction\": 0,\n \"currency\": \"RUB\",\n \"requestedDealAmount\": 4000,\n \"acceptedDealAmount\": 373.85,\n \"acceptedDealAmountUSDT\": 3.74,\n \"initialDealAmount\": 2000,\n \"initialDealAmountUSDT\": 20,\n \"created\": \"2025-10-21T11:39:06.160Z\",\n \"updated\": \"2025-10-21T11:39:06.160Z\",\n \"expired\": \"2025-10-21T14:39:06.160Z\",\n \"merchantFiles\": [\n \"/static/files/1cd4d645-74e1-4585-81d4-1e6e25ca0d2f.pdf\"\n ],\n \"traderFiles\": [\n \"/static/files/da7c6f0b-d6a5-4d18-b40f-eb75ab401728.pdf\"\n ]\n}\n\nHTTP 400 (+error details):
\nIf can't found deal or parameters error.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}},"urlObject":{"path":["api","external","disputes","db85190c-fcdb-4dad-bc34-23f31fd19030"],"host":["https://test.pay-guru.io"],"query":[],"variable":[]}},"response":[],"_postman_id":"ef98b17d-d3dc-4126-84ff-161fbe6d31c7"},{"name":"items","id":"30b8dcb1-53df-4fbc-a691-e15f9797c49a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/disputes/items?dealIn=true&dealOut=true&states=opened,accepted,rejected","description":"Return array of disputes, see status for each item
optional, default 'false'
\n","type":"text/plain"},"key":"dealIn","value":"true"},{"description":{"content":"optional, default 'false'
\n","type":"text/plain"},"key":"dealOut","value":"true"},{"disabled":true,"description":{"content":"optional
\n","type":"text/plain"},"key":"from","value":"2024-04-22T13:00:00Z"},{"disabled":true,"description":{"content":"optional
\n","type":"text/plain"},"key":"to","value":"2024-06-30T13:00:00Z"},{"description":{"content":"optional, default - all states
\n","type":"text/plain"},"key":"states","value":"opened,accepted,rejected"}],"variable":[]}},"response":[],"_postman_id":"30b8dcb1-53df-4fbc-a691-e15f9797c49a"},{"name":"items (from/to/...)","id":"b2201526-fd22-470c-9e39-769625e9449e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/disputes/items?dealIn=true&dealOut=true&from=2024-04-22T13:00:00Z&to=2024-06-30T13:00:00Z&state=1","description":"Return array of disputes, see status for each item
optional, default 'false'
\n","type":"text/plain"},"key":"dealIn","value":"true"},{"description":{"content":"optional, default 'false'
\n","type":"text/plain"},"key":"dealOut","value":"true"},{"description":{"content":"optional
\n","type":"text/plain"},"key":"from","value":"2024-04-22T13:00:00Z"},{"description":{"content":"optional
\n","type":"text/plain"},"key":"to","value":"2024-06-30T13:00:00Z"},{"description":{"content":"optional, default - all states
\n","type":"text/plain"},"key":"state","value":"1"}],"variable":[]}},"response":[],"_postman_id":"b2201526-fd22-470c-9e39-769625e9449e"}],"id":"f4495188-7717-477c-bdf3-4dbd38fdfefa","_postman_id":"f4495188-7717-477c-bdf3-4dbd38fdfefa","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}}},{"name":"Balance","item":[{"name":"get","id":"636f7c48-deae-4a5b-9b32-53bf2c141500","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/balance/get","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}},"urlObject":{"path":["api","external","balance","get"],"host":["https://test.pay-guru.io"],"query":[],"variable":[]}},"response":[],"_postman_id":"636f7c48-deae-4a5b-9b32-53bf2c141500"}],"id":"9b2fe1de-6b7b-4af8-adb7-064309ecbcdf","_postman_id":"9b2fe1de-6b7b-4af8-adb7-064309ecbcdf","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}}},{"name":"Banks","item":[{"name":"items","id":"585fcaf3-f926-42ff-b413-9ae04dfe6eac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/banks/items","description":"Return array of supported banks:
\n[\n {\n \"id\": 0,\n \"name\": \"СберБанк\",\n \"location\": \"RU\"\n },\n {\n \"id\": 1,\n \"name\": \"Раффайзен\",\n \"location\": \"RU\",\n },\n ...\n]\n\nPlease note that this list is constantly updated
\nlocation - country code (according to ISO-3166-1)
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}},"urlObject":{"path":["api","external","banks","items"],"host":["https://test.pay-guru.io"],"query":[],"variable":[]}},"response":[],"_postman_id":"585fcaf3-f926-42ff-b413-9ae04dfe6eac"}],"id":"831bcade-160d-4639-9fab-dc2a51af737d","_postman_id":"831bcade-160d-4639-9fab-dc2a51af737d","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}}},{"name":"Currencies","item":[{"name":"items","id":"f035fa17-ba5b-4e7a-8d57-5dd42ecc2a3f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/currencies/items","description":"Return array of supported currencies:
\n[\n \"RUB\",\n \"TRY\",\n \"KGS\",\n ...\n]\n\nReturn array of currency courses for deals:
\n[\n {\n \"currency\": \"RUB\",\n \"dealIn\": 91.32,\n \"dealOut\": 91.32\n },\n {\n \"currency\": \"TRY\",\n \"dealIn\": 46.28,\n \"dealOut\": 46.28\n },\n ...\n]\n\nSend immediate callback to:
\ndealIn - callbackUrl taken from deal OR from merchant settings (if deal callbackUrl empty)
dealOut - callbackUrl taken from deal OR from merchant settings (if deal callbackUrl empty)
dispute - callbackUrl taken from dealIn or dealOut (depends on dispute) OR from merchant settings (if deal callbackUrl empty)
Callback will send with CURRENT object state. For emulate different states see callbacks/ask with state
Use relative debug url for view callbacks to merchant, date/time, response, duration and status of response:
\n/callbacks/b0e49a10-479b-49bc-b61e-c42e058fbd44
b0e49a10-479b-49bc-b61e-c42e058fbd44 - deal or dispute id
\nExample of callback for dealIn
{\n \"type\": \"dealIn\",\n \"item\": /* content of dealIn/status */\n}\n\nExample of callback for dealOut
{\n \"type\": \"dealOut\",\n \"item\": /* content of dealIn/status */\n}\n\nExample of callback for dispute:
{\n \"type\": \"dispute\",\n \"item\": /* content of dispute/status */\n}\n\nSend immediate callback to custom url
\nCallback will send with CURRENT object state. For emulate different states see callbacks/ask with state
Callback format described in callbacks/ask method
optional custom url for send callback
\n","type":"text/plain"},"key":"url","value":"https://webhook.site/2dfa3738-853a-4a10-8512-7ecf4b3c8fc7"}],"variable":[]}},"response":[],"_postman_id":"98ed9f07-a8d6-4051-8f6c-c1684e59aeb8"},{"name":"ask with state","id":"e5137a9a-9c7b-4a17-88d7-44010a8d8a33","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/callbacks/ask/b0e49a10-479b-49bc-b61e-c42e058fbd44/created","description":"Send immediate callback to url (if specified) or to:
\ndealIn - callbackUrl taken from deal OR from merchant settings (if deal callbackUrl empty)
\ndealOut - callbackUrl taken from deal OR from merchant settings (if deal callbackUrl empty)
\ndispute - callbackUrl taken from dealIn or dealOut (depends on dispute) OR from merchant settings (if deal callbackUrl empty)
\ncreated - object state for callback. Depends from object. See dealIn/status or dealOut/status or disputes/status for get list of available state of object
Callback format described in callbacks/ask method
optional custom url for send callback
\n","type":"text/plain"},"key":"url","value":"https://webhook.site/2dfa3738-853a-4a10-8512-7ecf4b3c8fc7"}],"variable":[]}},"response":[],"_postman_id":"e5137a9a-9c7b-4a17-88d7-44010a8d8a33"}],"id":"012b5eb6-e902-4abc-b721-99e89e2a4ea7","_postman_id":"012b5eb6-e902-4abc-b721-99e89e2a4ea7","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}}},{"name":"Reports","item":[{"name":"deals/text","id":"26109e67-5afe-4ce2-9ab5-2111e72df034","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/reports/deals/text?dealIn=true&dealOut=true&states=created,success,cancelled,executing&from=2024-10-25T00:00:00Z&to=2024-10-26T13:00:00Z&locale=ru","description":"ID Направление Дата/время создания Дата/время выполнения Дата/время отмены Состояние Сумма в нац.валюте Сумма в USDT Сумма (с комиссией) в нац.валюте Сумма (с комиссией) в USDT Курс Номер карты Номер телефон Банк Ссылка на сделку Ссылка на чек Баланс мерчанта на момент создания сделки Баланс мерчанта после завершения сделки Количество споров ID споров Сумма до спора Сумма после спора\n202 Приём 13.08.2024 14:07:00 13.08.2024 14:07:05 Выполнена 10000.00 100.00 10300.00 103.00 100.00 1111111111111311 Sber /shared/3/fe583604-4f95-46fb-abfa-596706286ceb 1146.67 1001.28 \n203 Приём 13.08.2024 14:07:47 13.08.2024 14:07:52 Выполнена 10000.00 100.00 10300.00 103.00 100.00 1111111111111311 Sber /shared/3/456fce4b-2e64-448a-9de1-af03d945aed8 1241.77 1001.28 \n204 Приём 13.08.2024 14:09:02 13.08.2024 14:09:07 Выполнена 10000.00 100.00 10300.00 103.00 100.00 1111111111111311 Sber /shared/3/2e066067-fcfc-4833-bfc3-f41ecef33271 1336.87 1001.28 \n\noptional, default 'false'
\n","type":"text/plain"},"key":"dealIn","value":"true"},{"description":{"content":"optional, default 'false'
\n","type":"text/plain"},"key":"dealOut","value":"true"},{"description":{"content":"optional, default ALL states
\n","type":"text/plain"},"key":"states","value":"created,success,cancelled,executing"},{"description":{"content":"optional, UTC
\n","type":"text/plain"},"key":"from","value":"2024-10-25T00:00:00Z"},{"description":{"content":"optional, UTC
\n","type":"text/plain"},"key":"to","value":"2024-10-26T13:00:00Z"},{"description":{"content":"optional (ru/en), default en
\n","type":"text/plain"},"key":"locale","value":"ru"},{"disabled":true,"description":{"content":"optional (bank list from bank/items)
\n","type":"text/plain"},"key":"banks","value":"1,2,3"},{"disabled":true,"description":{"content":"optional (payment systems, 0 - any, 1 - HUMO, 2 - UzCard)
\n","type":"text/plain"},"key":"paymentSystems","value":"0,1,2"}],"variable":[]}},"response":[],"_postman_id":"26109e67-5afe-4ce2-9ab5-2111e72df034"},{"name":"deals/xlsx","id":"6cfad27d-5151-49d8-9145-d4d4ee516261","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://test.pay-guru.io/api/external/reports/deals/xlsx?dealIn=true&dealOut=true&states=created,success,cancelled&from=2024-10-25T00:00:00Z&to=2024-10-26T20:00:00Z&locale=ru&banks=1,2,3&paymentSystems=0,1,2","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}},"urlObject":{"path":["api","external","reports","deals","xlsx"],"host":["https://test.pay-guru.io"],"query":[{"description":{"content":"optional, default 'false'
\n","type":"text/plain"},"key":"dealIn","value":"true"},{"description":{"content":"optional, default 'false'
\n","type":"text/plain"},"key":"dealOut","value":"true"},{"description":{"content":"optional, default ALL states
\n","type":"text/plain"},"key":"states","value":"created,success,cancelled"},{"description":{"content":"optional, UTC
\n","type":"text/plain"},"key":"from","value":"2024-10-25T00:00:00Z"},{"description":{"content":"optional, UTC
\n","type":"text/plain"},"key":"to","value":"2024-10-26T20:00:00Z"},{"description":{"content":"optional (ru/en), default en
\n","type":"text/plain"},"key":"locale","value":"ru"},{"description":{"content":"optional (bank list from bank/items)
\n","type":"text/plain"},"key":"banks","value":"1,2,3"},{"description":{"content":"optional (payment systems, 0 - any, 1 - HUMO, 2 - UzCard)
\n","type":"text/plain"},"key":"paymentSystems","value":"0,1,2"}],"variable":[]}},"response":[],"_postman_id":"6cfad27d-5151-49d8-9145-d4d4ee516261"}],"id":"7cf9686d-890f-4c5f-9b5d-238c12d1a329","_postman_id":"7cf9686d-890f-4c5f-9b5d-238c12d1a329","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]},"isInherited":true,"source":{"_postman_id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","id":"6ab90f4a-d543-4554-afe4-32e5d71d5969","name":"PayGuru API v2","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"b23c0b04-33d9-4881-a59c-762350a24ad0"}]}},"event":[{"listen":"prerequest","script":{"id":"9c84bf35-91f7-44b2-b74e-7a76fec5bc68","type":"text/javascript","packages":{},"exec":["pm.globals.set('randomTrustLevel', Math.floor(Math.random()*100)/100.0);\r","pm.globals.set('randomAmount', 10 + Math.floor(Math.random() * 300000)/100.0);\r","\r","let cardNumber = [];\r","for (var i = 0; i < 16; i++)\r"," cardNumber.push(Math.floor((Math.random() * 9) + 0));\r","pm.globals.set('randomCardNumber', cardNumber.join(''));\r","\r","let phoneNumber = [7];\r","for (var i = 0; i < 10; i++)\r"," phoneNumber.push(Math.floor((Math.random() * 9) + 0));\r","pm.globals.set('randomPhoneNumber', phoneNumber.join(''));\r","\r","let start = new Date(2024, 0, 1);\r","let randomDateInPast = new Date(start.getTime() + Math.random() * (new Date().getTime() - start.getTime()))\r","pm.globals.set('randomDateInPast', randomDateInPast.toISOString());"]}},{"listen":"test","script":{"id":"caf0d054-594d-453a-9985-c5b206d25991","type":"text/javascript","packages":{},"exec":[""]}}],"variable":[{"key":"TOKEN","value":"b23c0b04-33d9-4881-a59c-762350a24ad0","type":"string"},{"key":"HOST","value":"https://test.pay-guru.io","type":"string"}]}