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

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

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

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

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

Info

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

Оплата

Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
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 в автоматическом уведомлении и в ответе на запрос статуса будет отличаться от значения, отправленного в первоначальном запросе на оплату, и будет равно фактической сумме платежа согласно информации в системе провайдера.

Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer
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": []
    }
  }
}

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

Запрос

Отправьте запрос выплаты средств со следующими данными:
object
object
Секция параметров способа выплаты.
type
обязательный
 string
bank_transfer
account_number
обязательный
 string
IBAN счета, на который будет осуществляться выплата.
bank_bic_number
обязательный
 string
BIC-код банка получателя выплаты.
object
Секция информации о получателе выплаты.
email
обязательный

 string
Адрес электронной почты получателя выплаты.
first_name
обязательный

 string
Имя получателя выплаты.
last_name
обязательный

 string
Фамилия получателя выплаты.
country
обязательный

 string
Страна получателя выплаты в формате ISO 3166-1 alpha-2.
address
обязательный

 string
Адрес получателя выплаты.
city
обязательный
 string
Город получателя выплаты.
state
 string
Штат получателя выплаты.
zip
обязательный
 string
Почтовый индекс получателя выплаты. Значение должно состоять только из заглавных латинских букв и/или цифр и не должно содержать специальные символы.
birth_date
обязательный

 string
Дата рождения получателя выплаты в формате ISO 8601 YYYY-MM-DD
gender
 string
Пол получателя выплаты.
Возможные значения:
male;
female.
phone
 string
Номер телефона получателя выплаты.
Пример запроса 
{
    "request": {
        "amount": 1700,
        "currency": "EUR",
        "description": "test",
        "test": true,
        "tracking_id": "your_uniq_number21212",
        "return_url": "https://your-success.url",
        "customer": {
            "email": "test@example.com",
            "first_name": "John",
            "last_name": "Willson",
            "country": "DE",
            "birth_date": "1980-01-01",
            "city": "Berlin",
            "zip": "10117",
            "address": "First Str. 2"            
        },
        "method": {
            "type": "bank_transfer",
            "account_number": "DE89370400440532013000",
            "bank_bic_number": "COBADEFFXXX"
        }
    }
}
Ответ
Пример ответа 
{
  "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": "test@example.com",
      "ip": null
    },
    "version": 0,
    "message": "Transaction was initialized.",
    "tracking_id": "your_uniq_number21212",
    "test": true,
    "billing_address": {          
      "first_name": "John",
      "last_name": "Willson",
      "country": "DE",          
      "email": "test@example.com",
      "city": "Berlin",
      "zip": "10117",
      "address": "First Str. 2",
      "birth_date": "1980-01-01",       
    },
    "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
    }
}