Payouts via online banking in Turkey

Payments via online banking in Turkey can be made using an IBAN or through a bank transfer.

To make account credits using online banking in Turkey, a request to the Tranzzo API must contain the following parameters:

Parameter	Type	Required	Description
pos_id	UUID	✅	Merchant's identifier (POS_ID)
mode	MODE	✅	direct
method	METHOD	✅	Payment method (credit)
amount	Number	✅	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)
currency	CURRENCY	✅	TRY
order_3ds_bypass	String	✅	3-D Secure flow option
order_id	String	✅	Unique identifier of order
description	String	✅	Payment description
payway	String	✅	banking
server_url	URL		Webhook notification will be sent to this URL
result_url	URL		Customer will be redirected to this URL after payment.
customer_fname	String	✅	Payer’s first name
customer_lname	String	✅	Payer’s last name
recipient_phone	String		Payer’s phone number. The parameter is mandatory for iban instrument type
customer_email	String	✅	Payer’s email address
properties.instrument_method	String		Instrument method alias. The parameter is mandatory for bank_transfer instrument type
properties.instrument_type	String	✅	Instrument type (iban or bank_transfer)
properties.iban	String	✅	Receiver’s IBAN
properties.document_id	String	✅	Recipient’s document number

The value of the payway parameter must be banking.

The customer_phone parameter is mandatory if a payout is made via iban.

The properties.instrument_method parameter is mandatory if a payout is made via bank_transfer.

Example request for a payout made via 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"
}

Example request for a payout made via 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"
}