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 paramenters

Payment methods

Find all the information about payment methods capabilities.

Bank transfers Wallet transfers

Bank information

Find all the bank account validations details you need to make a payout.

Bank account validations

Market 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 codecurrency codeamount decimalsdocument_type namedocument_id format
TRTRY2T.C. Kimlik No.Between 5 to 20 digits

Mandatory parameters

Bank transfers

Bank transfer parametersB2CB2BP2P
loginYesYesYes
passYesYesYes
external_idYesYesYes
beneficiary_nameYesYesYes
beneficiary_lastnameYesYesYes
countryYesYesYes
currencyYesYesYes
amountYesYesYes
bank_accountYesYesYes
phoneYesYesYes
purpose--Yes
remitter_document--Yes
remitter_full_name--Yes
remitter_country--Yes

Wallet transfers

Wallet transfer parametersB2CB2B
loginYesYes
passYesYes
external_idYesYes
beneficiary_nameYesYes
beneficiary_lastnameYesYes
countryYesYes
currencyYesYes
amountYesYes
account_typeYesYes
phoneOnly mandatory when account_type = "papara_mobile"Only mandatory when account_type = "papara_mobile"
bank_accountOnly 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 parameterDescription
loginAPI authentication credentials. Maximum 32 characters.
passAPI authentication credentials. Maximum 32 characters.
external_idUnique transaction identifier. Maximum 100 characters.
beneficiary_nameFirst name of the beneficiary. Maximum 50 characters.
beneficiary_lastnameLast name of the beneficiary. Maximum 50 characters.
countryCountry code. For Turkey, use TR.
currencyPayout currency. For Turkey, use TRY or USD.
amountPayout amount. Use up to 2 decimal places.
bank_accountBank account number. Maximum 26 characters (IBAN Format).
phonePhone number. Maximum 20 characters.
purposeReason for the payout. EPREMT for Remittance (P2P). Mandatory only for remittance (P2P).
remitter_documentDocument number of the sender. Maximum 45 characters. Mandatory only for remittance (P2P).
remitter_full_nameFull name of the sender. Maximum 100 characters. Mandatory only for remittance (P2P).
remitter_countryISO 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 parameterDescription
loginAPI authentication credentials. Maximum 32 characters.
passAPI authentication credentials. Maximum 32 characters.
external_idUnique transaction identifier. Maximum 100 characters.
beneficiary_nameFirst name of the beneficiary. Maximum 50 characters.
beneficiary_lastnameLast name of the beneficiary. Maximum 50 characters.
countryCountry code. For Turkey, use TR.
currencyPayout currency. For Turkey, use TRY or USD.
amountPayout amount. Use up to 2 decimal places.
account_typeType of wallet key being used: papara_mobile, papara_number.
phoneMobile 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_accountPapara 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.


Bank account validations


ValidationTypeLengthTypeVerification
Bank accountIBAN26CharactersIBAN algorithm