Перейти до основного вмісту

Виплати через онлайн-банкінг у Туреччині

Виплати через онлайн-банкінг у Туреччині можуть робитися за IBAN або через банківський переказ.

Для проведення зарахувань на рахунки за допомогою онлайн-банкінгу в Туреччині запит до API Tranzzo повинен містити такі параметри:

ParameterTypeRequiredDescription
pos_idUUID✅Merchant's identifier (POS_ID)
modeMODE✅direct
methodMETHOD✅Payment method (credit)
amountNumber✅Transaction amount. Must be a positive number. The number of decimal digits must be less than or equal to 2 (e.g., 100.00, 250, 50.50)
currencyCURRENCY✅TRY
order_3ds_bypassString✅3-D Secure flow option
order_idString✅Unique identifier of order
descriptionString✅Payment description
paywayString✅banking
server_urlURLWebhook notification will be sent to this URL
result_urlURLCustomer will be redirected to this URL after payment.
customer_fnameString✅Payer’s first name
customer_lnameString✅Payer’s last name
recipient_phoneStringPayer’s phone number. The parameter is mandatory for iban instrument type
customer_emailString✅Payer’s email address
properties.instrument_methodStringInstrument method alias. The parameter is mandatory for bank_transfer instrument type
properties.instrument_typeString✅Instrument type (iban or bank_transfer)
properties.ibanString✅Receiver’s IBAN
properties.document_idString✅Recipient’s document number

Значення параметру payway має бути передане як banking.

Параметр customer_phone є обовʼязковим, якщо використовується оплата за iban.

Параметр properties.instrument_method є обовʼязковим, якщо використовується оплата через bank_transfer.

Приклад запиту при оплаті за iban:

{
"pos_id": "00000000-0000-0000-0000-000000000000",
"mode": "direct",
"amount": 10,
"method": "credit",
"currency": "TRY",
"payway": "banking",
"customer_fname": "John",
"customer_lname": "Doe",
"customer_email": "[email protected]",
"customer_phone": "380000000000",
"properties": {
"instrument_type": "iban",
"iban": "TR440000000000000000000000",
"document_id": "00010001000"
},
"order_3ds_bypass": "supported",
"description": "Description",
"order_id": "1234567890",
"server_url": "http://callback-stub:9000/consume",
"result_url": "https://google.com"
}

Приклад запиту при оплаті через bank_transfer:

{
"pos_id": "00000000-0000-0000-0000-000000000000",
"mode": "direct",
"amount": 10,
"method": "credit",
"currency": "TRY",
"payway": "banking",
"customer_fname": "John",
"customer_lname": "Doe",
"customer_email": "[email protected]",
"properties": {
"instrument_method": "BANK_FINANSBANK",
"instrument_type": "bank_transfer",
"iban": "TR440000000000000000000000",
"document_id": "00010001000"
},
"order_3ds_bypass": "supported",
"description": "Description",
"order_id": "1234567890",
"server_url": "http://callback-stub:9000/consume",
"result_url": "https://google.com"
}