Turkey
Learn everything you need to know to make payouts in Turkey with dLocal.
Market specifications
Take a look of all the information you need to make a payout.
Country reference Mandatory paramentersPayment methods
Find all the information about payment methods capabilities.
Bank transfers Wallet transfersBank information
Find all the bank account validations details you need to make a payout.
Bank account validationsMarket specifications
Do you want to know more information about Turkey's market? Go to the Turkey’s economy and eCommerce market article.
Country reference
country code | currency code | amount decimals | document_type name | document_id format |
---|---|---|---|---|
TR | TRY | 2 | T.C. Kimlik No. | Between 5 to 20 digits |
Mandatory parameters
Bank transfers
Bank transfer parameters | B2C | B2B | P2P |
---|---|---|---|
login | Yes | Yes | Yes |
pass | Yes | Yes | Yes |
external_id | Yes | Yes | Yes |
beneficiary_name | Yes | Yes | Yes |
beneficiary_lastname | Yes | Yes | Yes |
country | Yes | Yes | Yes |
currency | Yes | Yes | Yes |
amount | Yes | Yes | Yes |
bank_account | Yes | Yes | Yes |
phone | Yes | Yes | Yes |
purpose | - | - | Yes |
remitter_document | - | - | Yes |
remitter_full_name | - | - | Yes |
remitter_country | - | - | Yes |
Wallet transfers
Wallet transfer parameters | B2C | B2B |
---|---|---|
login | Yes | Yes |
pass | Yes | Yes |
external_id | Yes | Yes |
beneficiary_name | Yes | Yes |
beneficiary_lastname | Yes | Yes |
country | Yes | Yes |
currency | Yes | Yes |
amount | Yes | Yes |
account_type | Yes | Yes |
phone | Only mandatory when account_type = "papara_mobile" | Only mandatory when account_type = "papara_mobile" |
bank_account | Only mandatory when account_type = "papara_number" | Only mandatory when account_type = "papara_number" |
Payment methods
Turkey supports payouts via Bank transfers and Wallet transfers. Each method requires specific parameters and follows validation rules aligned with local compliance and banking standards.
Use Wallet transfers for instant payments to mobile wallets. Use Bank transfers when sending funds directly to a bank account.
Bank transfers
Bank transfers in Turkey require detailed account information, including IBAN and phone number. The format of these fields depends on the receiving bank, and strict validation rules apply.
Refer to the bank account validations section for format specifications.
Mandatory parameters
All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.
Mandatory parameter | Description |
---|---|
login | API authentication credentials. Maximum 32 characters. |
pass | API authentication credentials. Maximum 32 characters. |
external_id | Unique transaction identifier. Maximum 100 characters. |
beneficiary_name | First name of the beneficiary. Maximum 50 characters. |
beneficiary_lastname | Last name of the beneficiary. Maximum 50 characters. |
country | Country code. For Turkey, use TR . |
currency | Payout currency. For Turkey, use TRY or USD . |
amount | Payout amount. Use up to 2 decimal places. |
bank_account | Bank account number. Maximum 26 characters (IBAN Format). |
phone | Phone number. Maximum 20 characters. |
purpose | Reason for the payout. EPREMT for Remittance (P2P). Mandatory only for remittance (P2P). |
remitter_document | Document number of the sender. Maximum 45 characters. Mandatory only for remittance (P2P). |
remitter_full_name | Full name of the sender. Maximum 100 characters. Mandatory only for remittance (P2P). |
remitter_country | ISO 3166-1 alpha-2 code of the sender. Mandatory only for remittance (P2P). |
Example request
{
"login": "1n234n56",
"pass": "HolAc123o",
"external_id": "1234567812345678b",
"beneficiary_name": "RUDRAH",
"beneficiary_lastname": "HASHIMI",
"country": "TR",
"bank_account": "TR123456789098765432123456",
"amount": "2064.00",
"phone": "+902125551212",
"currency": "TRY"
}
Wallet transfers
Wallet transfers enable real-time transfers using a mobile phone number or a Papara number linked to a wallet.
The account_type
field must indicate the type of wallet key being used (e.g., Papara Mobile, Papara Number). The phone
or bank_account
field must be present and correctly formatted based on the account_type
.
Mandatory parameters
The table below outlines the required parameters for Wallet transfers.
Mandatory parameter | Description |
---|---|
login | API authentication credentials. Maximum 32 characters. |
pass | API authentication credentials. Maximum 32 characters. |
external_id | Unique transaction identifier. Maximum 100 characters. |
beneficiary_name | First name of the beneficiary. Maximum 50 characters. |
beneficiary_lastname | Last name of the beneficiary. Maximum 50 characters. |
country | Country code. For Turkey, use TR . |
currency | Payout currency. For Turkey, use TRY or USD . |
amount | Payout amount. Use up to 2 decimal places. |
account_type | Type of wallet key being used: papara_mobile , papara_number . |
phone | Mobile phone number. Only mandatory when account_type = "papara_mobile" . Can be sent either with 10 digits (e.g. 1234567890) or with the country code (+90) plus 10 digits (e.g. +901234567890). |
bank_account | Papara number. Only mandatory when account_type = "papara_number" . Can be sent either with 10 digits (e.g. 1234567890) or with a 2 char prefix (e.g. PL1234567890). |
Example request
{
"login": "1n234n56",
"pass": "HolAc123o",
"external_id": "1234567812345678b",
"beneficiary_name": "RUDRAH",
"beneficiary_lastname": "HASHIMI",
"country": "TR",
"account_type": "papara_mobile",
"phone": "+902125551212",
"amount": "2064.00",
"currency": "TRY"
}
Bank information
Access the reference formats and accepted values required for processing bank payouts in Turkey.
Updated 6 days ago