Bank Transfer

SS Integration option

Payment flow

The customer initiates the payment on the merchant's website.
The merchant sends the payment request to PaynetworkGate.
PaynetworkGate sends a response containing the URL for completing the payment.
The merchant redirects the customer to the provided URL.
The customer completes the payment.
PaynetworkGate sends a webhook notification with the payment status to the merchant. The merchant may also request the payment status from PaynetworkGate with the status query.

Info

This integration option supports only EUR currency.

Payment

Request

Send a payment request with the following additional parameters:

object

return_url

required

string
A URL to return the customer to when a transaction is completed.

object
A section of the payment method information.

type required	string `bank_transfer`.
channel	string The customer's billing country in the ISO 3166-1 Alpha-2 format. Possible values: `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 example

{
  "request": {
      "test": true,
      "amount": 500,
      "currency": "EUR",
      "description": "description",
      "return_url": "https://return.com",
      "method": {
          "type": "bank_transfer",
          "channel": "ES"
      }
  }
}

Response

Redirect your customer to the URL received as the value of the form.action parameter.

Response example

{
    "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 Integration option

Info

This integration option supports only EUR currency.

Payment

Payment flow

The customer initiates the payment on the merchant's website.
The merchant sends the payment request to PaynetworkGate.
PaynetworkGate sends a response containing the URL for completing the payment.
The merchant redirects the customer to the provided URL.
The customer submits the required information if necessary and completes the payment.
PaynetworkGate sends a webhook notification with the payment status to the merchant. The merchant may also request the payment status from PaynetworkGate with the status query.

Warning

If the customer edits the payment amount on the provider's payment page before completing the payment, the amount parameter value in the webhook notification and in the response to the transaction status query will be different from the value sent in the initial payment request and will equal the actual paid amount according to the information in the provider's system.

Request

Send a payment request with the following additional parameters:

object

return_url

required

string
A URL to return the customer to when a transaction is completed.

object
A section of the payment method information.

type

required

string
bank_transfer.

object
A section of information about the customer.

first_name required	string The customer's first name.
last_name required	string The customer's last name.
email required	string The customer's email address.
birth_date required	string The customer's date of birth in the ISO 8601 format (`YYYY-MM-DD`).
country required	string (2) The customer's billing country in the ISO 3166-1 Alpha-2 format. Possible values: `AD` (Andorra), `AT` (Austria), `BE` (Belgium), `BG` (Bulgaria), `HR` (Croatia), `CY` (Cyprus), `CZ` (Czechia), `DK` (Denmark), `EE` (Estonia), `FI` (Finland), `FR` (France), `DE` (Germany), `GR` (Greece), `HU` (Hungary), `IS`(Iceland), `IE` (Ireland), `IT` (Italy), `LV` (Latvia), `LI` (Liechtenstein), `LT` (Lithuania), `LU` (Luxembourg), `MT` (Malta), `MC` (Monaco), `NL` (Netherlands), `NO` (Norway), `PL` (Poland), `PT` (Portugal), `RO` (Romania), `SM` (San Marino), `SK` (Slovakia), `SI` (Slovenia), `ES` (Spain), `SE` (Sweden), `CH` (Switzerland), `GB` (United Kingdom). The new countries are continually added to the list of possible values.
phone	string The customer's phone number without the special characters.
address	string The customer's address.
zip	string (6) The post code of the customer's billing address.
gender	string The customer's gender. Possible values: `male`; `female`.

Request example

{
    "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"           
        }
    }
}

Response

Redirect your customer to the URL received as the value of the form.action parameter.

Response example

{
  "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": "widget-ti/g?paytoken=3a9526a3-8075-4573-b370-9b281cea8ca6",
      "method": "GET",
      "fields": []
    }
  }
}

Payout

Request

Send a payout request with the following additional data:

object

object
A section of the payout method.

type required	string `bank_transfer`
account_number required	string IBAN of the account for the payout.
bank_bic_number required	string BIC code of the bank to which the payout is made.

object
A section of information about the payout recipient.

email required	string The email address of the payout recipient.
first_name required	string The first name of the payout recipient.
last_name required	string The last name of the payout recipient.
country required	string The country of the payout recipient in ISO 3166-1 Alpha-2 format.
address required	string The billing address of the payout recipient.
city required	string The billing city of the payout recipient.
state	string The billing state of the payout recipient.
zip required	string The post code of the billing address of the payout recipient. The value can include only uppercase latin letters and/or numbers and must not include special symbols.
birth_date required	string The payout recipient's date of birth in the ISO 8601 format (YYYY-MM-DD).
gender	string The gender of the payout recipient. Possible values: `male`; `female`.
phone	string The phone number of the payout recipient.

Request example

{
  "request": {
      "amount": 66,
      "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"
      }
  }
}

Response

Response example

{
  "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"
      }
    }    
  }
}

Balance query

Request

Send a balance query request with the following additional data:


gateway_id required	integer Gateway ID for your shop in the PaynetworkGate system. To get the gateway ID, contact Tech Support Team or your account manager.
currency required	string An account currency in the ISO-4217 alpha-3 code format. In this case, `EUR`.

Request example

{
    "gateway_id": 4870,
    "currency": "EUR"
}

Response

Response example

{
    "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
    }
}