Введение

Добро пожаловать в API

Авторизация

Примеры подписи:

func Sign(msg, key []byte) (string, error) { // msg - тело запроса, key - ваш секретный ключ
mac := hmac.New(sha512.New, key)
_, err := mac.Write(msg)
if err != nil{
return "", err
}

return hex.EncodeToString(mac.Sum(nil)), nil
}

Заголовки авторизации:

API-Key - ваш API ключ

Signature - результат подписи тела запроса алгоритмом HMACSHA512 (кодирвка - hex)

Другие обязательные заголовки:

Content-Type - application/json

Вывод денег

Вывод на карту

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/withdraw_to_card_v2 \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
 "recipient": "5555555555555555",
 "amount": 120000,
 "callbackURL": "https://d6c3-185-196-238-169.ngrok.io/",
 "UID": "0f87a56b-7318-43f9-9637-058b4bd6fce8",
 "clientInfo":{
    "client": "987234234987",
    "email": "[email protected]",
    "c_from": "RUB",
    "c_to": "RUB",
    "txn": "8732984792837",
    "ip": "140.113.223.125",
    "user_agent": "Mozilla/5.0 (iPhone12,1; U; CPU iPhone OS 13_0 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/10.0 Mobile/15E148 Safari/602.1",
    "recipient": "5555555555555555"
 }
 }`

Ответ в случае успеха:

{
  "status": "Accepted",
  "externalID": "91BDDFD5-E920-4E3A-82CC-2A029F6D1F1B"
  // ID для идентификации
}

Ответ в случае неуспеха:

{
  "status": "cannot",
  "cause": "cannot"
  // описание причины
}

Параметр	Тип	Пример значения	Обязательный	Описание
recipient	`string`	3472850978567732	Да	Номер карты получателя
amount	`int`	500000	Да	Сумма к отправке
callbackURL	`string`	https://d6c3-185-196-238-169.ngrok.io/order_32435	Нет	Ссылка на которую придет `GET` запрос после присвоения этому ордеру конечного статуса
UID	`string`	0f87a56b-7318-43f9-9637-058b4bd6fce8	Да	Уникальный идентификатор заявки клиента
client	`string`	987234234987	Да	Идентификатор конечного пользователя в вашей системе
email	`string`	[email protected]	Да	Почта конечного пользователя
c_from	`string`	RUB	Да	Код валюты отправителя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
c_to	`string`	RUB	Да	Код валюты получателя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
txn	`string`	8732984792837	Да	ID-транзакции внутри вашей системы
ip	`string`	140.113.223.125	Да	IP пользователя
user_agent	`string`	Mozilla/5.0 (iPhone12,1; U; CPU iPhone OS 13_0 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/10.0 Mobile/15E148 Safari/602.1	Да	UserAgent браузера клиента
recipient	`string`	3472850978567732	Да	Номер карты, необходимо повторно указать

Вывод по СБП

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/withdraw_sbp \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
 "recipient": "79154445875",
 "amount": 2000,
 "callbackURL": "https://d6c3-185-196-238-119.ngrok.io/",
 "methodID": 2,
 "UID": "0f88a56b-7318-43f9-9637-058b4bd6fce8",
 "clientInfo":{
    "client": "987284234987",
    "email": "[email protected]",
    "c_from": "RUB",
    "c_to": "RUB",
    "txn": "8732984792837",
    "ip": "140.113.283.125",
    "user_agent": "Mozilla/5.0 (iPhone12,1; U; CPU iPhone OS 13_0 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/10.0 Mobile/15E148 Safari/602.1",
    "recipient": "79154445875"
 }
 }`

Ответ в случае успеха:

{
  "status": "Accepted",
  "externalID": "91BDDFD5-E920-4E3A-82CC-2A029F6D1F1B"
  // ID для идентификации
}

Ответ в случае неуспеха:

{
  "status": "cannot",
  "cause": "cannot"
  // описание причины
}

Параметр	Тип	Пример значения	Обязательный	Описание
recipient	`string`	79154445875	Да	Номер телефона получателя
amount	`int`	2000	Да	Сумма к отправке
callbackURL	`string`	https://d6c3-185-196-238-119.ngrok.io/order_32435	Нет	Ссылка на которую придет `GET` запрос после присвоения этому ордеру конечного статуса
methodID	`int`	2	Да	Указывется ID банка, на который делается вывод. Список methodID: 2-Tinkoff, 3-SBER, 4-Raiffeisen, 5-Otkritie, 6-ALFA, 7-VTB, 8-MKB, 9-Sovcombank, 10-Rosselkhozbank, 11-Rosbank, 12-UNICredit, 13-Gazprom, 14-Elite, 15-Avangard
UID	`string`	0f88a56b-7318-43f9-9637-058b4bd6fce8	Да	Уникальный идентификатор заявки клиента
client	`string`	987284234987	Да	Идентификатор конечного пользователя в вашей системе
email	`string`	[email protected]	Да	Почта конечного пользователя
c_from	`string`	RUB	Да	Код валюты отправителя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
c_to	`string`	RUB	Да	Код валюты получателя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
txn	`string`	8732984792837	Да	ID-транзакции внутри вашей системы
ip	`string`	140.113.283.125	Да	IP пользователя
user_agent	`string`	Mozilla/5.0 (iPhone12,1; U; CPU iPhone OS 13_0 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/10.0 Mobile/15E148 Safari/602.1	Да	UserAgent браузера клиента
recipient	`string`	79154445875	Да	Номер телефона, необходимо повторно указать

Вывод на QIWI кошелек

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/withdraw_to_qiwi_v2 \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
 "recipient": "79999999999",
 "amount": 120000,
 "callbackURL": "https://d6c3-185-196-238-169.ngrok.io/",
 "UID": "0f87a56b-7318-43f9-9637-058b4bd6fce8",
 "clientInfo":{
    "client": "987234234987",
    "email": "[email protected]",
    "c_from": "RUB",
    "c_to": "RUB",
    "txn": "8732984792837",
    "ip": "140.113.223.125",
    "user_agent": "Mozilla/5.0 (iPhone12,1; U; CPU iPhone OS 13_0 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/10.0 Mobile/15E148 Safari/602.1",
    "recipient": "79999999999"
 }
}'

Ответ в случае успеха:

{
  "status": "Accepted",
  "externalID": "91BDDFD5-E920-4E3A-82CC-2A029F6D1F1B"
  // ID для идентификации
}

Ответ в случае неуспеха:

{
  "status": "cannot",
  "cause": "cannot"
  // описание причины
}

Параметр	Тип	Пример	Обязательный	Описание
recipient	`string`	79999999999	Да	Номер кошелька получателя
amount	`int`	500000	Да	Сумма к отправке
callbackURL	`string`	https://d6c3-185-196-238-169.ngrok.io/order_32435	Нет	Ссылка на которую придет `GET` запрос после присвоения этому ордеру конечного статуса
UID	`string`	0f87a56b-7318-43f9-9637-058b4bd6fce8	Да	Уникальный идентификатор заявки клиента
client	`string`	987234234987	Да	Идентификатор конечного пользователя в вашей системе
email	`string`	[email protected]	Да	Почта конечного пользователя
c_from	`string`	RUB	Да	Код валюты отправителя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
c_to	`string`	RUB	Да	Код валюты получателя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
txn	`string`	8732984792837	Да	ID-транзакции внутри вашей системы
ip	`string`	140.113.223.125	Да	IP пользователя
user_agent	`string`	Mozilla/5.0 (iPhone12,1; U; CPU iPhone OS 13_0 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/10.0 Mobile/15E148 Safari/602.1	Да	UserAgent браузера клиента
recipient	`string`	79999999999	Да	Номер карты, необходимо повторно указать

Ввод денег 3DS и H2H методами

Генерация инвойса с возможностью оплаты картой х2х, киви кошельком, киви p2p, с помощью нашей формы

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/generate_invoice_form \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
    "amount": 120000,
    "expireAt": 900,
    "callbackURL": "https://d6c3-185-196-238-169.ngrok.io/",
    "comment": "comment",
    "paySourcesFilter": "qw,card,h2h",
    "successRedirectURL": "http://google.com",
    "failedRedirectURL": "http://google.com",
    "clientInfo":{
        "client": "987234234987",
        "email": "[email protected]",
        "c_from": "RUB",
        "c_to": "RUB",
        "txn": "8732984792837"
    }
  }'

Ответ в случае успеха:

{
  "success": true,
  // успешно ли
  "UID": "0E8866FC-EF1F-47FD-A764-22A224B160E1",
  // ID для идентификации ордера
  "paymentURL": "https://payment.mpcvip.ru/0E8866FC-EF1F-47FD-A764-22A224B160E1"
  // ссылка на фомру оплаты
}

Ответ в случае неуспеха:

{
  "success": false,
  // успешно ли
  "cause": "cannot"
  // описание причины
}

Параметр	Тип	Пример	Обязательный	Описание
amount	`int`	500000	Да	Сумма к отправке
expireAt	`int`	900	да	Время, которое ордер будет жить в секундах
callbackURL	`string`	https://d6c3-185-196-238-169.ngrok.io/order_32435	Нет	Ссылка на которую придет `GET` запрос после присвоения этому ордеру конечного статуса
comment	`string`		Да	Будет отображаться на странице оплаты
paySourcesFilter	`string`	`qw,card,h2h`	Да	`card` - оплата будет доступна только картой через форму киви, `qw` - оплата будет доступна только киви кошем, `h2h` - оплата с помощью h2h, можно выбирать несколько вариантов
successRedirectURL	`string`		нет	Адрес куда будет перенаправлен пользователь после успешной оплаты
failedRedirectURL	`string`		нет	Адрес куда будет перенаправлен пользователь после неуспешной оплаты
clientUID	`string`	5fa1eea3-f821-4cdd-b889-3480e6ea6333	Нет	Можете отправлять сюда ID ордера в вашей системе, чтобы легче искать в веб-клиенте
client	`string`	987234234987	Да	Идентификатор конечного пользователя в вашей системе
email	`string`	[email protected]	Да	Почта конечного пользователя
c_from	`string`	RUB	Да	Код валюты отправителя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
c_to	`string`	RUB	Да	Код валюты получателя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
txn	`string`	8732984792837	Да	ID-транзакции внутри вашей системы

Генерация инвойса форма h2h

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/generate_invoice_h2h \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
    "amount": 120000,
    "expireAt": 900,
    "callbackURL": "https://d6c3-185-196-238-169.ngrok.io/",
    "comment": "comment",
    "paySourcesFilter": "",
    "successRedirectURL": "http://google.com",
    "failedRedirectURL": "http://google.com",
    "cardNumber": "7689",
    "clientInfo":{
        "client": "987234234987",
        "email": "[email protected]",
        "c_from": "RUB",
        "c_to": "RUB",
        "txn": "8732984792837"
    }
  }'

Ответ в случае успеха:

{
  "success": true,
  "UID": "579ECFC2-8898-48F8-BF31-289AE7952C92",
  "paymentURL": "https://payment3ds.mpcvip.ru/579ECFC2-8898-48F8-BF31-289AE7952C92"
}

Ответ в случае неуспеха:

{
  "success": false,
  // успешно ли
  "cause": "cannot"
  // описание причины
}

Параметр	Тип	Пример	Обязательный	Описание
amount	`int`	500000	Да	Сумма к отправке
expireAt	`int`	900	да	Время, которое ордер будет жить в секундах
callbackURL	`string`	https://d6c3-185-196-238-169.ngrok.io/order_32435	Нет	Ссылка на которую придет `GET` запрос после присвоения этому ордеру конечного статуса
comment	`string`		Да	Будет отображаться на странице оплаты
paySourcesFilter	`string`		Да	card или qw
successRedirectURL	`string`		нет	Адрес куда будет перенаправлен пользователь после успешной оплаты
failedRedirectURL	`string`		нет	Адрес куда будет перенаправлен пользователь после неуспешной оплаты
clientUID	`string`	5fa1eea3-f821-4cdd-b889-3480e6ea6333	Нет	Можете отправлять сюда ID ордера в вашей системе, чтобы легче искать в веб-клиенте
client	`string`	987234234987	Да	Идентификатор конечного пользователя в вашей системе
email	`string`	[email protected]	Да	Почта конечного пользователя
c_from	`string`	RUB	Да	Код валюты отправителя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
c_to	`string`	RUB	Да	Код валюты получателя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
txn	`string`	8732984792837	Да	ID-транзакции внутри вашей системы

Генерация инвойса h2h

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/generate_invoice_3ds \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
    "amount": 500,
    "expireAt": 1233,
    "comment": "123",
    "clientUID": "456",
    "callbackURL": "https://yourdomain.com/456",
    "successRedirectURL": "http://google.com",
    "failedRedirectURL": "http://google.com",
    "pan": "4279380624454321",
    "cvv": "712",
    "month": "11",
    "year": "2025",
    "clientInfo":{
        "client": "987234234987",
        "email": "[email protected]",
        "c_from": "RUB",
        "c_to": "RUB",
        "txn": "8732984792837",
        "sender": "4279380624454321",
        "ip" : "140.113.223.125",
        "user_agent": "Mozilla/5.0 (iPhone12,1; U; CPU iPhone OS 13_0 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/10.0 Mobile/15E148 Safari/602.1",
    }
}

Ответ в случае успеха:

{
  "externalID": "53a47c77-bbc1-41cc-bbd9-4631d8cd6575",
  "success": true,
  "cause": "",
  "redirectUrl": "https://payment-3ds.com/payin-3ds-spa/acs-10?data=A8zt-Cu5rnUQB6eLuwuFx6h-yPbJAOE9jJmUtbXqUaj3lj1WCczBcVwIRK3qU3x1u8dAWhbuj8fDuiQjB49bLt0aJtBIDHltDlO1mE_450MN-Q_KP9GVvtNjpqBTSGLOuorFn43s7MH-Fg6BD820_BjbNhM1jEpuygRXH_rviXo&MD=dLgLG4U96uk3wAhsiSOoQ612PetvonS7YfHcR%2FjWzb63S4d5FPy5ecwJi8m5vvV2C6DQ1q%2FakZ89ZpxCKnR57CwGYGry5Y0rou1byXO7pwGpXpZo1n1%2FJ8AyOaCd%2B6z5lzLi5L0%2Fv%2B178tatqktS8gwArathcwPlR0ldZ3ECvKhfcLbYAIjXDZsBR4Zp4s%2FExGmWyJXOwFT1h53EIoCK3OHPETC6Y6qeu%2Fwo1f50currBm06GIB6Vx5yCuiJJ39u6ZvWch0tJcCCRvLh87QKeTYaRepOmjIc223rAvLAhdHcQgX%2Bg7oTMf4vCoy2G6643CVpAf3AOWg24aWxEbzNbw%3D%3D&PaReq=eJxVUl1vgjAU%2FSvEF55GSykC5lKDY8vIItONxWdSGiWRD%2FmYbr9%2BLYJuTZrcc2577r2nheWlOGpfomnzqvR108C6JkpeZXm59%2FXP5PnB1ZcMkkMjRPgheN8IBmvRtuleaHnmz%2FB1mZ7lUA%2B71ME2njHYBO%2FixGAUZlLXIIAmKBUafkjLjkHKT6soZtR05sQBNEIoRBOFjFI8LepaGNCVhjItBNtGu0hbBfEroAEDr%2Fqya77ZnFqAJgB9c2SHrqsXCJ3yc27wqgCkSED3Lja9ilopcskztg6D83U%2F2esfjt%2BSgMYhP8dJ4ANSJyBLO8EIJhY2LayZeGHShe0BGnhIC1Wd2dg2sOx6hFCrKsEtp1J%2FKZDuNtL8aYIJgbjUVSnkCWnhLYZMtJxtd1pX1Q99LUsrDOg%2ByuOLspd30jGCbddzPYcQU3k8cEo2lw4Rit1BVwFA6hYanw%2BNLy2jfz%2FgF4QAtIY%3D&TermUrl=https%3A%2F%2Fmasterprocessingvip.ru%2Fapi%2Fpayment%2Ffinish_3ds"
  //После чего вам необходимо отправить post запрос на адрес из RedirectUrl и произойдет перенаправление на 3ds форму.
}

После чего вам необходимо отправить post запрос на адрес из RedirectUrl и произойдет перенаправление на 3ds форму.

Ответ в случае неуспеха:

{
  "success": false,
  // успешно ли
  "cause": "cannot"
  // описание причины
}

Параметр	Тип	Пример	Обязательный	Описание
amount	`int`	500000	Да	Сумма к отправке
expireAt	`int`	900	да	Время, которое ордер будет жить в секундах
callbackURL	`string`	https://d6c3-185-196-238-169.ngrok.io/order_32435	Нет	Ссылка на которую придет `GET` запрос после присвоения этому ордеру конечного статуса
comment	`string`		Да	Будет отображаться на странице оплаты
successRedirectURL	`string`		нет	Адрес куда будет перенаправлен пользователь после успешной оплаты
failedRedirectURL	`string`		нет	Адрес куда будет перенаправлен пользователь после неуспешной оплаты
clientUID	`string`	5fa1eea3-f821-4cdd-b889-3480e6ea6333	Нет	Можете отправлять сюда ID ордера в вашей системе, чтобы легче искать в веб-клиенте
pan	`string`	4279380624454321	да	Номер карты
cvv	`string`	712	да	CVV карты
month	`string`	11	да	Месяц до которого валидна карты
year	`string`	2025	да	Год до которого валидна карта
client	`string`	987234234987	Да	Идентификатор конечного пользователя в вашей системе
email	`string`	[email protected]	Да	Почта конечного пользователя
c_from	`string`	RUB	Да	Код валюты отправителя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
c_to	`string`	RUB	Да	Код валюты получателя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
txn	`string`	8732984792837	Да	ID-транзакции внутри вашей системы
ip	`string`	140.113.223.125	Да	IP пользователя
user_agent	`string`	Mozilla/5.0 (iPhone12,1; U; CPU iPhone OS 13_0 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/10.0 Mobile/15E148 Safari/602.1	Да	UserAgent браузера клиента
sender	`string`	4279380624454321	Да	Номер карты, необходимо повторно указать

Ввод денег через P2P решение

Генерация инвойса реквизитного решения с помощью нашей формы

Время но оплату - 30 минут.

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/create_p2p_form \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
    "amount": 532,
    "paySource": 1,
    "successRedirectURL": "http://google.com",
    "failedRedirectURL": "http://google.com",
    "callbackURL": "https://d6c3-185-196-238-169.ngrok.io/"
    }'

для того чтобы на форме были только СБП реквизиты необходимо указать currencyName: "SBP"
для того чтобы на форме был только QR необходимо указать currencyName: "QR"

Ответ в случае успеха:

{
  "externalID": "REFER-20f34b6f-dcce-4f49-8492-143b89b4b1d5",
  "success": true,
  "cardNumber": "",
  "paymentURL": "https://cardforpay24.ru/5983e549-4fc4-49d2-a161-bd5fb2a4d498",
  "cause": ""
}

Ответ в случае неуспеха:

{
  "success": false,
  // успешно ли
  "cause": "cannot"
  // описание причины
}

Параметр	Тип	Пример	Обязательный	Описание
amount	`int`	500000	Да	Сумма к отправке
paySource	`int`	1	Да	Всегда 1 в этом запрос
successRedirectURL	`string`		нет	Адрес куда будет перенаправлен пользователь после успешной оплаты
failedRedirectURL	`string`		нет	Адрес куда будет перенаправлен пользователь после неуспешной оплаты
callbackURL	`string`	https://d6c3-185-196-238-169.ngrok.io/order_32435	Нет	Ссылка на которую придет `GET` запрос после присвоения этому ордеру конечного статуса

Генерация инвойса с помощью реквизитного решения

Время но оплату - 30 минут.

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/create_p2p \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
    "amount": 532,
    "paySource": 1,
    "callbackURL": "https://d6c3-185-196-238-169.ngrok.io/"
    }'

paySource:
CARDRUB = 1
TCSBRUB = 2
SBERRUB = 3
RFBRUB = 4
OPNBRUB = 5
ALFARUB = 6
VTBRUB = 7
MKBRUB = 8
SOVKRUB = 9

для СБП реквизитов необходимо указать currencyName: "SBP"
для QR необходимо указать currencyName: "QR"

При запросе QR придет изображение в формате Base64

Ответ в случае успеха:

{
  "externalID": "REFER-20f34b6f-dcce-4f49-8492-143b89b4b1d5",
  "success": true,
  "cardNumber": "2202211111111111",
  "cause": ""
}

Ответ в случае неуспеха:

{
  "success": false,
  // успешно ли
  "cause": "cannot"
  // описание причины
}

Параметр	Тип	Пример	Обязательный	Описание
amount	`int`	500000	Да	Сумма к отправке
paySource	`int`	1	Да	Банк карты
callbackURL	`string`	https://d6c3-185-196-238-169.ngrok.io/order_32435	Нет	Ссылка на которую придет `GET` запрос после присвоения этому ордеру конечного статуса
uid	`string`	5fa1eea3-f821-4cdd-b889-3480e6ea6333	Нет	Можете отправлять сюда ID ордера в вашей системе, чтобы легче искать в веб-клиенте

Апелляция оплаты по реквизитному решению

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/appeal_p2p \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
        "externalID": "P2P-2d8593e3-4dec-43b0-a59f-39d7364e4345",
        "image": "iVBORw0KGgoAAAA"
}'

Параметр	Тип	Пример	Обязательный	Описание
externalID	`string`	REFER-2de4501a-7afe-459e-aff0-171bbc91cdd6	Да	ID ордера
image	`string`		Да	закодированное в base64 изображение чека в формате png или jpeg

Подтверждение оплаты по реквизитному решению

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/confirm_p2p \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
      "externalID": "REFER-2de4501a-7afe-459e-aff0-171bbc91cdd6"
}'

Параметр	Тип	Пример	Обязательный	Описание
externalID	`string`	REFER-2de4501a-7afe-459e-aff0-171bbc91cdd6	Да	ID ордера

Отмена оплаты по реквизитному решению

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/cancel_p2p \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
    "externalID": "REFER-2de4501a-7afe-459e-aff0-171bbc91cdd6"
}'

Параметр	Тип	Пример	Обязательный	Описание
externalID	`string`	REFER-2de4501a-7afe-459e-aff0-171bbc91cdd6	Да	ID ордера

Получение информации

Получение баланса

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/get_balance \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \

Ответ в случае успеха:

{
  "balance": 2300000
}

Получение истории транзакций

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/fetch_order_history \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
    "orderType": null,
    "amountFrom": null,
    "amountTo": null,
    "createdAtFrom": null,
    "createdAtTo": null
}'

Ответ:

[
  {
    "externalID": "987668FA-DF62-4647-AF8A-404A1B10453F",
    "apiName": "TESTSYSTEM",
    "statusName": "success",
    "successPaid": 5,
    "amount": 5,
    "type": "withdraw",
    "success": true,
    "createdAt": 1649846186.191999
  },
  {
    "externalID": "b31b0c19-9bed-4fff-9f98-8f01c99aee47",
    "apiName": "TESTSYSTEM",
    "statusName": "payed",
    "successPaid": 5,
    "amount": 5,
    "type": "invoice",
    "success": true,
    "createdAt": 1649335239.236371
  }
]

Отправлять значение null, если параметр не задан.

Параметр	Тип	Пример	Обязательный	Описание
orderType	`string`	«withdraw»	нет	тип ордера (invoice или withdraw)
amountFrom	`int`	14000	нет	сумма от (вернуть ордера, сумма которых больше заданной)
amountTo	`int`	14000	нет	сумма до (вернуть ордера, сумма которых меньше заданной)
createdAtFrom	`int`	1649928150	нет	unix время создания ордера (вернуть ордера, созданные после заданного времени)
createdAtTo	`int`	1649928150	нет	unix время создания ордера (вернуть ордера, созданные до заданного времени)

Получение информации о withdraw ордере

Пример запроса с использованием нашего ID:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/get_withdraw_order_info \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
    "externalID": "91BDDFD5-E920-4E3A-82CC-2A029F6D1F1B"
}'

Пример запроса с использованием вашего UID:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/get_withdraw_order_info_by_uid \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
    "UID": "123132213"
}'

Ответ:

{
  "externalID": "91BDDFD5-E920-4E3A-82CC-2A029F6D1F1B",
  // внешний ID
  "createdAt": 1634290022.756475,
  // время создания в Unix
  "flowStats": {
    "total": 120000,
    // всего к разливу
    "success": 120000,
    // успешно разлито
    "waiting": 0,
    // ожидает разлива
    "failed": 0
    // разлив неуспешен
  },
  "flowDetails": [
    {
      "amount": 60000,
      "statusID": 4,
      "statusName": "history successfully checked",
      "failCause": ""
    },
    {
      "amount": 60000,
      "statusID": 4,
      "statusName": "history successfully checked",
      "failCause": ""
    }
  ],
  // подробная информация о разливе
  "success": true,
  // успешно ли
  "statusName": "success",
  // имя статуса
  "recipient": "79999999999",
  // получатель
  "recipientTypeName": "QIWI"
  // имя типа получателя
}

Возможные статусы:

`statusName`	финальный ли	описание
new	нет	В обработке
success	да	Успешно
filed	да	Неуспешно
partially success	да	Неуспешно (закрыто оператором, возможна частичная оплата)
Unsupported card provider	да	Карта не поддерживается

При обработке информации об ордере необходимо опираться не только на statusName, но и на сравнение total, success и waiting.

Так же необходимо проверять externalID в ответ с запрашиваемым.

Смотреть историю стоит только после уведомления callback'a

Параметр	Тип	Пример	Обязательный	Описание
externalID	`string`	91BDDFD5-E920-4E3A-82CC-2A029F6D1F1B	Да	ID ордера

Получение информации об invoice ордере

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/get_invoice_order_info \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
    "externalID": "E8AB9A42-2779-48BB-BBBD-A7EB6605550E"
}'

Ответ:

{
  "externalID": "E8AB9A42-2779-48BB-BBBD-A7EB6605550E",
  // ID заявки
  "createdAt": 1636633667.032243,
  // время создания
  "payedTime": 1636633742,
  // крайнее время оплаты
  "amount": 900000,
  // сумма к оплате
  "successPayed": 900000,
  // успешно оплачено
  "failedPayed": 0,
  //неуспешно оплачено
  "success": true,
  // успешно ли
  "statusName": "payed"
  // имя статуса
}

Возможные статусы:

`statusName`	финальный ли	описание
new	нет	при создании ордера
paymentTimeoutNotPayed	да/нет	если клиент не оплатил ордер в заданное время
payed	да	если клиент оплатил ордер в заданное время, так же этот статус может быть, если оплаченная сумма не равна сумме ордера
paymentTimeoutPartiallyPayed	да/нет	если клиент оплатил не все счета, не в заданное время
payedAfterTimeout	да	может быть такой кейс, что вы поставили время жизни ордера, например, 40 минут, клиент оплатил в это время, но банк задержал транзакцию на сутки. В итоге сначала статус будет paymentTimeoutNotPayed (по истечении заданных вами 40 минут). Но в случае если банк потом все таки пропустит эту транзакцию, или после п2п апелляции, ордер примет статус payedAfterTimeout.
internalError	да	Внутренняя ошибка
rejected	да	Отклонено банком или была нажата кнопка отмены 3ds

При обработке иформации об ордере необходимо опираться не только на statusName, но и на сравнение amount и successPayed.

Так же необходимо проверять externalID в ответ с запрашиваемым.

Рекомендуем смотреть историю только после уведомления callback'a

Параметр	Тип	Пример	Обязательный	Описание
externalID	`string`	E8AB9A42-2779-48BB-BBBD-A7EB6605550E	Да	ID ордера

Функционирование callback

Когда вы инициируете запрос на вывод или ввод, в поле callbackURL вы можете указать адрес, на который прийдет GET запрос в момент присвоения этому ордеру конечного статуса. В случае если ваш сервис ответил не кодом - 200, наш API будет повторять этот запрос каждую минуту до пятидесяти раз.

Алгоритм работы такой: Вы, в callbackURL передаёте адрес формата вашдомен.com/уникальныйidордераввашейсистеме И когда вам приходит get запрос по этому адресу(уникальный_idордераввашей_системе), вы тянете из вашей базы externalID (который мы выдали при инициации запроса) и вставляете его в get_invoice_details/get_withdraw_details. То есть, когда мы кидаем запрос по callback - это значит, что ордеру присвоился конечный статус и можно посмотреть полные данные.

USDT

Получение текущего курса USDT

Пример запроса:

curl --request GET \
  --url https://masterprocessingvip.ru/api/payment/get_current_rate \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \

Ответ в случае успеха:

{
  "price": 104.716901,
  // Курс
  "time": 1648125979.8131247
  // Текущее время
}

Получение конкретной информации по ордеру на ввод

Ответ сервера 204 - если заявка не найдена

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/get_invoice_order_info_usdt \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
    "externalID": "9b395da6-b651-47b1-aa2b-0280974f581"
  }'

Ответ в случае успеха:

{
  "externalID": "9b395da6-b651-47b1-aa2b-0280974f581",
  // Уникальный ID заявки
  "createdAt": 1648052252.01535,
  // Дата создания
  "payedTime": 1648052292,
  // Дата оплаты
  "amount": 49,
  // Сумма, зачисленная на счет, с учетом комиссии
  "successPayed": 50,
  // Сумма, которую оплатил пользователь
  "failedPayed": 0,
  // Сумма, которую не оплатил пользователь (в случае создания нескольких ссылок)
  "success": true,
  // true - если пользователь оплатил все ссылки, иначе false
  "statusName": "payed",
  // Статус 
  "rate": 108.488443
  // Курс USDT-TRC20. Устанавливается в момент оплаты  
}

Генерация инвойса p2p USDT

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/generate_p2p_v3_usdt \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \
  --data '{
    "amount": 120000,
    "expireAt": 1635346756,
    "callbackURL": "https://d6c3-185-196-238-169.ngrok.io/",
  "comment": "comment",
  "paySourcesFilter": "",
  "cardNumber": "13245657689",
  "clientInfo":{
        "client": "987234234987",
        "email": "[email protected]",
        "c_from": "RUB",
        "c_to": "USDT",
        "txn": "8732984792837",
        "user_agent": "Mozilla/5.0 (iPhone12,1; U; CPU iPhone OS 13_0 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/10.0 Mobile/15E148 Safari/602.1",
        "IP": "128.1.4.65",
    }
  }'

Ответ в случае успеха:

{
  "success": true,
  // успешно ли
  "billID": "F245E9B4-1C09-4572-985F-9A9E980A962A",
  // ID для идентификации ордера
  "paymentLinks": [
    "https://qiwi.com/payment/form/99?extra%5B%27account%27%5D=79999999999&amountInteger=120000&amountFraction=00&extra%5B%27comment%27%5D=B1BCBD46-436F-4E29-81FA-2F7ABBD3E45F&currency=643&blocked%5B0%5D=account&blocked%5B1%5D=comment&blocked%5B2%5D=sum"
  ]
  // Массив ссылок. Ордер считается успешно выполненным в случае если произведена оплата по всем ссылкам
}

Ответ в случае неуспеха:

{
  "success": false,
  // успешно ли
  "cause": "cannot"
  // описание причины
}

Параметр	Тип	Пример	Обязательный	Описание
amount	`int`	500000	Да	Сумма к отправке
expireAt	`int`	900	да	Время, которое ордер будет жить в секундах
callbackURL	`string`	https://d6c3-185-196-238-169.ngrok.io/order_32435	Нет	Ссылка на которую придет `GET` запрос после присвоения этому ордеру конечного статуса
comment	`string`		Да	Будет отображаться на странице оплаты
clientIP	`string`	140.113.223.125	Да	IP Клиента
paySourcesFilter	`string`		Да	card или qw
cardNumber	`string`	"1234"	Да	Последние 4 цифры карты, с которой будет оплата в случае оплаты картой
client	`string`	987234234987	Да	Идентификатор конечного пользователя в вашей системе
email	`string`	[email protected]	Да	Почта конечного пользователя
c_from	`string`	RUB	Да	Код валюты отправителя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
c_to	`string`	RUB	Да	Код валюты получателя, если транзакция предназначена для дальнейшего обмена, необходимо указывать.
txn	`string`	8732984792837	Да	ID-транзакции внутри вашей системы
ip	`string`	140.113.223.125	Да	IP пользователя
user_agent	`string`	Mozilla/5.0 (iPhone12,1; U; CPU iPhone OS 13_0 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) Version/10.0 Mobile/15E148 Safari/602.1	Да	UserAgent браузера клиента

При выполнении входящей операции на кошелек (направление обмена qiwi -> что-то другое), необязательными для заполнения являются следующие поля:

sender
sender_system (либо указывать qiwi)
c_from (либо заполнять RUB)
partner (при отсутствии партнерской схемы)

В случае выплатной операции с кошелька, необязательными являются следующие поля:

recipient (значение поля совпадает с заполненной информацией в самой операции)
recipient_system (аналогично)
c_to (аналогично)

Получение баланса usdt

Пример запроса:

curl --request POST \
  --url https://masterprocessingvip.ru/api/payment/get_usdt_balance \
  --header 'Content-Type: application/json' \
  --header 'API-Key: QSgl9IABZCohSjwHvold3LuboEb2D8aaKvCPDROEGkImGw0dRkYWP0Ar4H3GpYQN4BORkfcH7zKgVLtMTYIwKQnrH997L81TIrfMdzdLVNUASSD9yEJRL5lfP2f8aEm1226jzZchFb8AkppzsMrg4en24L4ceu2bMzI18lCejZkkt2F4fZwNAvJwFevt2Qr2fERuIqGIsZFmGGkRZxK6xv0Px5fKPvtBibyGPt5PGOR9vsxFdPWfwz1ASCNBRXYV' \
  --header 'Signature: 7b90fb844080b2z61e7b8024bcad299f3d33368943d9b720f51cea41c64e31d4fb6a3e730fe5a52f0cf8f4662178e7ce3c3235387724fe27e4f9689f6vcxd3b2' \

Ответ в случае успеха:

{
  "balance": 2300000
}