Skip to content

Bank Transfer

SS Integration option

Payment flow

  1. The customer initiates the payment on the merchant's website.
  2. The merchant sends the payment request to PaynetworkGate.
  3. PaynetworkGate sends a response containing the URL for completing the payment.
  4. The merchant redirects the customer to the provided URL.
  5. The customer completes the payment.
  6. 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:

Parameter Type Description
request object
return_url
* required
 string A URL to return the customer to when a transaction is completed.
method object A section of the payment method information.
type
* required
 string bank_transfer.
channel
* required
 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

  1. The customer initiates the payment on the merchant's website.
  2. The merchant sends the payment request to PaynetworkGate.
  3. PaynetworkGate sends a response containing the URL for completing the payment.
  4. The merchant redirects the customer to the provided URL.
  5. The customer submits the required information if necessary and completes the payment.
  6. 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:

Parameter Type Description
request object
return_url
* required
 string A URL to return the customer to when a transaction is completed.
method object A section of the payment method information.
type
* required
 string bank_transfer.
customer * required
 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:

Parameter Type Description
request object
method object A section of the payment method information.
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.
customer * required
 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:

Parameter Type Description
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
    }
}