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

Банковский перевод

Вариант интеграции SS

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

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет запрос оплаты в PaynetworkGate.
  3. PaynetworkGate присылает в ответе секцию form с полем action, содержащим URL страницы оплаты.
  4. Продавец перенаправляет покупателя на страницу из параметра form.action из ответа PaynetworkGate.
  5. Страница отображает список банков, доступных для страны, указанной в method.channel. Покупатель выбирает банк, приложение которого он будет использовать для оплаты, и завершает транзакцию.
  6. PaynetworkGate отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у PaynetworkGate с помощью запроса получения статуса транзакции.

Info

Этот вариант интеграции поддерживает только валюту EUR.

Оплата

Запрос

Отправьте запрос оплаты со следующими данными:

Параметр Тип Описание
request object
return_url
* обязательный		 string URL, на который будет возвращен покупатель после завершения оплаты.
method object Секция параметров способа оплаты.
type
* обязательный		 string bank_transfer
channel
* обязательный		 string Страна банка покупателя в формате ISO 3166-1 alpha-2. Возможные значения: AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IS, IE, IT, LV, LI, LT, LU, MT, NL, NO, PL, PT, RO, SK, SI, ES, SE, GB.
Пример запроса 
{
  "request": {
      "test": true,
      "amount": 500,
      "currency": "EUR",
      "description": "description",
      "return_url": "https://return.com",
      "method": {
          "type": "bank_transfer",
          "channel": "ES"
      }
  }
}
Ответ

Отправьте покупателя на URL, указанный в параметре form.action.

Пример ответа 
{
    "transaction": {
        "uid": "d7b88f80-f714-4f64-9aeb-dc880b3b7b4a",
        "type": "payment",
        "status": "pending",
        "amount": 2300,
        "currency": "EUR",
        "description": "test",
        "created_at": "2025-01-11T11:31:09Z",
        "updated_at": "2025-01-11T11:31:10Z",
        "method_type": "bank_transfer",
        "receipt_url": "https://backoffice.paynetworks.io/customer/transactions/d7b88f80-f714-4f64-9aeb-dc880b3b7b4a/e598bbe9b8a2deaf99fbcefca028f6c6c2b7eedf593d3ee37151e9acd61844da?language=ru",
        "payment": {
            "status": "pending",
            "gateway_id": 4824,
            "ref_id": "4214474",
            "message": "Invoice is created successfully, waiting for a payment",
            "bank_code": 31
        },
        "bank_transfer": {
            "type": "bank_transfer"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Invoice is created successfully, waiting for a payment",
        "tracking_id": "your_uniq_number21212",
        "test": true,
        "language": "en",
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "https://test-ss/hosted?transaction-id=5e747509-4b2e-8a0a-03ea-5697eb",
            "method": "GET",
            "fields": []
        }
    }
}

Вариант интеграции TI

Info

Этот вариант интеграции поддерживает только валюту EUR.

Оплата

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

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет запрос оплаты в PaynetworkGate.
  3. PaynetworkGate присылает в ответе секцию form с полем action, содержащим URL страницы оплаты.
  4. Продавец перенаправляет покупателя на страницу из параметра form.action из ответа PaynetworkGate.
  5. Покупатель вводит дополнительные данные при необходимости и завершает транзакцию.
  6. PaynetworkGate отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у PaynetworkGate с помощью запроса получения статуса транзакции.

Warning

Если покупатель отредактирует сумму оплаты на странице провайдера, то значение параметра amount в автоматическом уведомлении и в ответе на запрос статуса будет отличаться от значения, отправленного в первоначальном запросе на оплату, и будет равно фактической сумме платежа согласно информации в системе провайдера.

Запрос

Отправьте запрос оплаты со следующими данными:

Параметр Тип Описание
request object
return_url
* обязательный		 string URL, на который будет возвращен покупатель после завершения оплаты.
method object Секция параметров способа оплаты.
type
* обязательный		 string bank_transfer
customer object Секция информации о покупателе.
first_name * обязательный string Имя покупателя.
last_name * обязательный string Фамилия покупателя.
email * обязательный
 string Адрес электронной почты покупателя.
birth_date * обязательный
 string Дата рождения покупателя в формате ISO 8601 YYYY-MM-DD
country * обязательный string Страна покупателя в формате ISO 3166-1 alpha-2. Возможные значения: AD (Андорра), AT (Австрия), BE (Бельгия), BG (Болгария), HR (Хорватия), CY (Кипр), CZ (Чехия), DK (Дания), EE (Эстония), FI (Финляндия), FR (Франция), DE (Германия), GR (Греция), HU (Венгрия), IS (Исландия), IE (Ирландия), IT (Италия), LV (Латвия), LI (Лихтенштейн), LT (Литва), LU (Люксембург), MT (Мальта), MC (Монако), NL (Нидерланды), NO (Норвегия), PL (Польша), PT (Португалия), RO (Румыния), SM (Сан-Марино), SK (Словакия), SI (Словения), ES (Испания), SE (Швеция), CH (Швейцария), GB (Великобритания). Новые страны регулярно добавляются в список возможных значений.
phone string Номер телефона покупателя без специальных символов.
address string (510) Адрес покупателя.
zip string (6) Почтовый индекс покупателя.
gender string Пол покупателя.
Возможные значения:
male;
female.
Пример запроса 
{
    "request": {
        "test": true,
        "amount": 1500,
        "currency": "EUR",
        "description": "description",
        "return_url": "https://return.com",
        "method": {
            "type": "bank_transfer"            
        },
        "customer": {
            "first_name": "John",
            "last_name": "Willson",
            "email": "test@example.com",
            "birth_date": "01-01-1980",
            "country": "PL"           
        }
    }
}
Ответ

Отправьте покупателя на URL, указанный в параметре form.action.

Пример ответа 
{
  "transaction": {
    "uid": "e3c5039e-87fc-4553-8927-492bd336b333",
    "type": "payment",
    "status": "pending",
    "amount": 1500,
    "currency": "EUR",
    "description": "description",
    "created_at": "2025-01-21T11:51:37Z",
    "updated_at": "2025-01-21T11:51:41Z",
    "method_type": "bank_transfer",
    "receipt_url": "https://backoffice.paynetworks.io/customer/transactions/e3c5039e-87fc-4553-8927-492bd336b333/71f10fec5a13acc218f1ef5392608a52774e528959ba819c1bebbed81ba145c1",
    "payment": {
      "status": "pending",
      "gateway_id": 4870,
      "ref_id": "OR-250121115141530",
      "message": "Transaction was initialized."
    },
    "bank_transfer": {
      "type": "bank_transfer"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Willson",
      "email": "test@example.com",
      "country": "PL",
      "birth_date": "1980-01-01",
      "ip": null
    },
    "manually_corrected_at": null,
    "version": 0,
    "message": "Transaction was initialized.",
    "test": true,
    "billing_address": {
      "first_name": "John",
      "last_name": "Willson",
      "email": "test@example.com",
      "country": "PL",
      "birth_date": "1980-01-01"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },  
    "gateway": {
      "iframe": true
    },
    "form": {
      "action": "https://widget-ti/g?paytoken=3a9526a3-8075-4573-b370-9b281cea8ca6",
      "method": "GET",
      "fields": []
    }
  }
}

Выплата средств

Запрос

Отправьте запрос выплаты средств со следующими данными:

Параметр Тип данных Описание
request object
method object Секция параметров способа оплаты.
type
* обязательный		 string bank_transfer
account
* обязательный		 string IBAN счета покупателя, на который будет осуществляться выплата.
bank_bic_number
* обязательный		 string BIC-код банка получателя выплаты.
customer * обязательный object Секция информации о покупателе.
email * обязательный
 string Адрес электронной почты покупателя.
Пример запроса 
{
    "request": {
        "amount": 1700,
        "currency": "EUR",
        "description": "test",
        "test": true,
        "tracking_id": "your_uniq_number21212",
        "return_url": "https://your-success.url",
        "customer": {
            "email": "willson@example.com"            
        },
        "method": {
            "type": "bank_transfer",
            "account": "TA07W1H3AW3LR",
            "bank_bic_number": "4ZFPPB1UT4"
        }
    }
}
Ответ
Пример ответа 
{
  "transaction": {
    "uid": "1c1e000a-831d-4ebe-9a90-4110cc4afc0b",
    "type": "payout",
    "status": "pending",
    "amount": 1700,
    "currency": "EUR",
    "description": "test",
    "created_at": "2025-01-21T14:38:43Z",
    "updated_at": "2025-01-21T14:38:47Z",
    "manually_corrected_at": null,
    "method_type": "bank_transfer",
    "receipt_url": "https://backoffice.paynetworks.io/customer/transactions/1c1e000a-831d-4ebe-9a90-4110cc4afc0b/51bb913f735e3a4aab13b582afce01dc8744d938d8079e17720cc7ffa83fe6a5",
    "payout": {
      "status": "pending",
      "gateway_id": 4870,
      "message": "Transaction was initialized.",
      "bank_code": "06"
    },
    "bank_transfer": {
      "type": "bank_transfer"
    },
    "customer": {
      "email": "willson@example.com",
      "ip": null
    },
    "version": 0,
    "message": "Transaction was initialized.",
    "tracking_id": "your_uniq_number21212",
    "test": true,
    "billing_address": {      
      "email": "willson@example.com"      
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    }    
  }
}

Запрос баланса

Запрос

Отправьте запрос баланса со следующими данными:

Параметр Тип данных Описание
gateway_id
* обязательный		 integer ID платежного шлюза для вашего магазина в системе PaynetworkGate. Чтобы получить идентификатор шлюза, обратитесь в службу поддержки или к вашему менеджеру.
currency
* обязательный		 string Валюта счета в формате ISO-4217 alpha-3 code. В данном случае, EUR.
Пример запроса 
{
    "gateway_id": 4870,
    "currency": "EUR"
}
Ответ
Пример ответа 
{
    "code": "S.0000",
    "status": "successful",
    "message": "Got balance",
    "friendly_message": "Successfully processed",
    "gateway_id": 4870,
    "amount": 0,
    "currency": "EUR",
    "provider_info": {
        "currency": "EUR",
        "totalCollectionsAmount": 0,
        "totalPayoutAmount": 797.8,
        "totalSettledAmount": 0,
        "totalUnsettledAmount": -797.8,
        "totalPayoutFee": 0,
        "totalPayoutInTransitBalance": 0
    }
}