Создание заявки на пополнение (PayIn)

Внимание!

Все запросы к API Void Pay необходимо отправлять с вашего сервера

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

Перед созданием платежа вам необходимо получить информацию о ограничениях в сумме запроса, эта информация понадобится для отрисовки формы для пользователя

curl --request GET \
  --url https://api.hostname.com/api/v1/merchant/payments/currencies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json'

Пример ответа

{
    "currencies": [
        {
            "max": 50000,
            "min": 300,
            "code": "rub"
        }
    ]
}

Создание платежа в системе Void Pay

С полученной информацией о ограничениях мы можем создать платеж в системе

Описание полей запроса

Параметр	Описание	Пример
`type`	`Тип платежа`	`direct`
`amount`	`Сумма`	`300`
`orderId`	`Индетификатор заказа в системе продавца`	`9453`
`currency`	`Валюта`	`rub`

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

curl --request POST \
  --url https://api.voidpay.biz/api/v1/merchant/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "direct",
    "amount": 300,
    "orderId": "9453",
    "currency": "rub",
  "method": "card-to-card"
}'

Пример ответа

{
  "payment": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "rate": {
      "USDT": {
        "price": 0,
        "createdAt": "2024-01-16T17:58:43.097Z"
      }
    },
    "orderId": "string",
    "userId": "string",
        "status": "new",
        "amount": 300,
    "sourcePan": "string",
    "currency": "rub",
    "total": {
      "currency": "USDT",
      "amount": 0
    },
    "expiredAt": "2024-01-16T17:58:43.097Z"
  },
  "card": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "pan": "string",
    "phone": "string",
    "bankIssuer": "tinkoff"
  },
  "redirectUrl": "https://checkout2.voidpay.biz/eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJ0eXBlIjoiZGlyZWN0IiwibWV0aG9kIjoic2JwIiwicGF5bWVudElkIjoiZDg5NTM0YmItMTg1NC00YjhmLTg4ODItNWMwODY1YzIwY2I4Iiwib3JkZXJJZCI6ImQwZDZmMDMzLTBjNDQtNDA2NC1iOWNjLWZhOTYzMDRhOTlkYSIsImV4cGlyZWRBdCI6IjIwMjQtMDEtMTZUMTg6MTM6MjcuODAyWiIsImN1cnJlbmN5Ijp7InZhbHVlIjoicnViIiwib3B0aW9ucyI6eyJydWIiOnsibWF4IjozMDAwMDAsIm1pbiI6MTAwfX19LCJhbW91bnQiOjExMSwicGFuIjoiMjIwMDcwMDYyMjMzNzkwNCIsImlhdCI6MTcwNTQyODA4NywiZXhwIjoxNzA1NDI5ODg3fQ.43wTYwpi0PKWiuw1vZ8OZ4gQlSvCsyC-pnI8uMpgCWAzIV1hoziccDRcsjiXeAFMiQLA11yVYb6dpVdlfmq_CA/payment-sbp"
}

Создание платежа по СБП в системе Void Pay с редиректом

Описание полей запроса

Параметр	Описание	Пример
`type`	`Тип платежа`	`direct`
`amount`	`Сумма`	`300`
`orderId`	`Индетификатор заказа в системе продавца`	`9453`
`currency`	`Валюта`	`rub`
`sbpEnabled`	`Активирован ли СБП`	`true`

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

curl --request POST \
  --url https://api.voidpay.biz/api/v1/merchant/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "direct",
    "amount": 300,
    "orderId": "9453",
    "currency": "rub",
    "method": "sbp"
}'

При direct типе оплате и sbpEnabled: true поле redirectUrl (см. пример ответа) будет содержать ссылку на страницу оплаты с уже выбранным номером оплаты, при таком типе оплаты от пользователя требуется минимум действий

Получение СБП реквизитов в системе Void Pay

Если вы хотите получить реквизиты для выдачи их на своей стороне вам подойдет запрос описанный выше

curl --request POST \
  --url https://api.voidpay.biz/api/v1/merchant/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "direct",
    "amount": 300,
    "orderId": "9453",
    "currency": "rub",
    "method": "sbp"
}'

В ответе, вы сможете забрать телефон для оплаты (Формат: 90033356422) по полю card.phone (см. пример ответа)

Создание платежа для перевода по СЧЕТУ в системе Void Pay с редиректом

Если вы хотите получить реквизиты для выдачи их на своей стороне вам подойдет следующий запрос

curl --request POST \
  --url https://api.voidpay.biz/api/v1/merchant/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "staged",
    "amount": 300,
    "orderId": "9453",
    "currency": "rub",
    "method": "account-to-account"
}'

В ответе, вы сможете забрать страницу для редиректа по полю redirectUrl (см. пример ответа)

Получение реквизитов для перевода по СЧЕТУ в системе Void Pay

Если вы хотите получить реквизиты для выдачи их на своей стороне вам подойдет следующий запрос

curl --request POST \
  --url https://api.voidpay.biz/api/v1/merchant/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "direct",
    "amount": 300,
    "orderId": "9453",
    "currency": "rub",
    "method": "account-to-account"
}'

В ответе, вы сможете забрать номер счета для оплаты (Формат: 18273618271726346000) по полю card.pan (см. пример ответа)

Создание зарубежного перевода

Для создания перевода по номеру телефона в другую страну подойдет следующий запрос. Если вы хотите убрать сбор номера телефона пользователя используйте type: direct

curl --request POST \
  --url https://api.voidpay.biz/api/v1/merchant/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "staged",
    "amount": 300,
    "orderId": "9453",
    "currency": "rub",
    "method": "by-phone",
    "transferScope": "international"
}'

Пример ответа

{
  "payment": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "rate": {
      "USDT": {
        "price": 0,
        "createdAt": "2024-01-16T17:58:43.097Z"
      }
    },
    "orderId": "string",
    "userId": "string",
        "status": "new",
        "amount": 300,
    "sourcePan": "string",
    "currency": "rub",
    "total": {
      "currency": "USDT",
      "amount": 0
    },
    "expiredAt": "2024-01-16T17:58:43.097Z"
  },
  "card": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "pan": "string",
    "phone": "string",
    "bankIssuer": "tinkoff"
  },
  "redirectUrl": "https://checkout2.voidpay.biz/eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJ0eXBlIjoiZGlyZWN0IiwibWV0aG9kIjoic2JwIiwicGF5bWVudElkIjoiZDg5NTM0YmItMTg1NC00YjhmLTg4ODItNWMwODY1YzIwY2I4Iiwib3JkZXJJZCI6ImQwZDZmMDMzLTBjNDQtNDA2NC1iOWNjLWZhOTYzMDRhOTlkYSIsImV4cGlyZWRBdCI6IjIwMjQtMDEtMTZUMTg6MTM6MjcuODAyWiIsImN1cnJlbmN5Ijp7InZhbHVlIjoicnViIiwib3B0aW9ucyI6eyJydWIiOnsibWF4IjozMDAwMDAsIm1pbiI6MTAwfX19LCJhbW91bnQiOjExMSwicGFuIjoiMjIwMDcwMDYyMjMzNzkwNCIsImlhdCI6MTcwNTQyODA4NywiZXhwIjoxNzA1NDI5ODg3fQ.43wTYwpi0PKWiuw1vZ8OZ4gQlSvCsyC-pnI8uMpgCWAzIV1hoziccDRcsjiXeAFMiQLA11yVYb6dpVdlfmq_CA/payment-sbp"
}

Создание перевода (Т-Банк)

Для создания перевода по номеру телефона в другую страну для пользователя Т-Банка подойдет следующий запрос. Если вы хотите убрать сбор номера телефона пользователя используйте type: direct

curl --request POST \
  --url https://api.voidpay.biz/api/v1/merchant/payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "staged",
    "amount": 300,
    "orderId": "9453",
    "currency": "rub",
    "method": "sbp",
  "bankIssuer": "tinkoff"
}'

Пример ответа

{
  "payment": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "rate": {
      "USDT": {
        "price": 0,
        "createdAt": "2024-01-16T17:58:43.097Z"
      }
    },
    "orderId": "string",
    "userId": "string",
        "status": "new",
        "amount": 300,
    "sourcePan": "string",
    "currency": "rub",
    "total": {
      "currency": "USDT",
      "amount": 0
    },
    "expiredAt": "2024-01-16T17:58:43.097Z"
  },
  "card": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "pan": "string",
    "phone": "string",
    "bankIssuer": "tinkoff"
  },
  "redirectUrl": "https://checkout2.voidpay.biz/eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJ0eXBlIjoiZGlyZWN0IiwibWV0aG9kIjoic2JwIiwicGF5bWVudElkIjoiZDg5NTM0YmItMTg1NC00YjhmLTg4ODItNWMwODY1YzIwY2I4Iiwib3JkZXJJZCI6ImQwZDZmMDMzLTBjNDQtNDA2NC1iOWNjLWZhOTYzMDRhOTlkYSIsImV4cGlyZWRBdCI6IjIwMjQtMDEtMTZUMTg6MTM6MjcuODAyWiIsImN1cnJlbmN5Ijp7InZhbHVlIjoicnViIiwib3B0aW9ucyI6eyJydWIiOnsibWF4IjozMDAwMDAsIm1pbiI6MTAwfX19LCJhbW91bnQiOjExMSwicGFuIjoiMjIwMDcwMDYyMjMzNzkwNCIsImlhdCI6MTcwNTQyODA4NywiZXhwIjoxNzA1NDI5ODg3fQ.43wTYwpi0PKWiuw1vZ8OZ4gQlSvCsyC-pnI8uMpgCWAzIV1hoziccDRcsjiXeAFMiQLA11yVYb6dpVdlfmq_CA/payment-sbp"
}

Создание заявки на пополнение (PayIn)

Получение информации о ограничениях​

Создание платежа в системе Void Pay​

Создание платежа по СБП в системе Void Pay с редиректом​

Получение СБП реквизитов в системе Void Pay​

Создание платежа для перевода по СЧЕТУ в системе Void Pay с редиректом​

Получение реквизитов для перевода по СЧЕТУ в системе Void Pay​

Создание зарубежного перевода​

Создание перевода (Т-Банк)​

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

Создание платежа в системе Void Pay

Создание платежа по СБП в системе Void Pay с редиректом

Получение СБП реквизитов в системе Void Pay

Создание платежа для перевода по СЧЕТУ в системе Void Pay с редиректом

Получение реквизитов для перевода по СЧЕТУ в системе Void Pay

Создание зарубежного перевода

Создание перевода (Т-Банк)