Перейти к содержанию

Внесение денежных средств с использованием модели On Site Redirect

Этот раздел описывает вариант использования системы Moneygate при внесении денежных средств c использованием модели On Site Redirect, при котором создание платежного ордера осуществляется при помощи HTTP-запросов к API Moneygate после чего кастомер перенаправляется во внешнее веб-приложение Pay'n'Play для совершения платежа. API Moneygate.

Предварительно выполненные действия

Мерчант зарегистрировался в системе Moneygate.

Руководство по регистрации в системе.

Дополнительный вариант использования системы Moneygate при внесении денежных средств

Шаг 1 – Создание платежного ордера

Получение текущего статуса платежного ордера

Получение текущего статуса платежного ордера может быть осуществлено двумя способами:

  1. Запрос статуса системой мерчанта при помощи API функции /on-site-redirect/status
  1. Получение статуса от системы Moneygate при помощи webhook-запросов /on-site-redirect/status

Пример внесения средств Card To Card

В текущем примере будет выполнено внесение 100 000 TJS (таджикский сомони) на карту банка Dushanbe City Bank.

Шаг 1 – Создание платежного ордера

API-функция позволяет создать новый платежный ордер на внесение денежных средств с использованием модели On Site Redirect со способом перевода карта-карта (card2card).

Пример для Linux shell

curl -X POST --location 'https://moneygate.master.blowfish.api4ftx.cloud/v1/host-to-host/deposit-orders/new' 
--header 'X-Auth-Token: $token_string' 
--header 'X-Auth-Sign: $sign_string'
--header 'Content-Type: application/json'
--header 'Accept: application/json'
--data '{
    "id": "449bc546-e589-4aca-83fd-771423844649",
    "service_id": 6001,
    "data": {
        "callback_url": "https://merchant-side.com/send-status-here",
        "payment_type": "card2card",
        "amount": 10000000,
        "currency": "TJS"
    }
}'

Запрос имеет заголовки аутентификации (Руководство по аутентификации запросов):

  • X-Auth-Token.
  • X-Auth-Sign.

В теле запроса (body request) определены следующие свойства:

  • id, тип string – ID ордера, генерируется в системе мерчанта. Уникален в системе мерчанта.
  • service_id, тип integer – ID услуги имеет значение 6001.
  • data.callback_url, тип string – URL ресурса на стороне мерчанта по которому будут направляться обратные вызовы с изменениями статуса платежного ордера.
  • payment_type, тип string – Способ перевода.
  • data.amount, тип integer – Сумма платежа в разменных денежных единицах (в нашем случае 100000 таджикских сомони).
  • data.currency, тип string – Буквенный код валюты по стандарту ISO 4217.

В результате выполнения запроса будет получен следующий body response:

{
    "success": true
    "id": "449bc546-e589-4aca-83fd-771423844649",
    "data": {
        "blowfish_id": "b3a7349c-13b8-490a-a002-7549c99a0dcf",
        "payment_url": "https://payhub.develop.blowfish.api4ftx.cloud/FcU2bncAuu22uLCBm28xAKHcx7YrryyYfqe4GDf2bpGCprAAzspLq832TTMvunivKYmvMjv2LrkgaWMKX71kPxi8nMk6D9KJnBYBM7NnJ7bCccN7Tw6CrCbs4BtBxW9grBMR3xuhXz8WSdEFfjEcwAive2Y8dQpvtBxuKhuvVyrXgvWAmnnGD7AvUDjrggwhg5jbqQCeL8KQTzcbBJofXopaZJNgAJyterW6HuYoVYrmbmff78NK6fHXJ46iMZ53FhLeG"
    },
}

В ответе содержатся следующие свойства:

  • success, тип boolean – представляет успешную операцию создания платежного ордера.
  • id, тип string – ID ордера, генерируется в системе мерчанта.Уникален в системе мерчанта.
  • data.blowfish_id, тип string – ID ордера, генерируется в системе Moneygate.
  • data.payment_url, тип string – URL ресурса на стороне платежного провайдера, который будет использован клиентом для совершения операции оплаты.