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` code	`currency` code	`amount` decimals	`beneficiary.document.type` name	`beneficiary.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
`external_id`	Yes	Yes	Yes
`payment_method_id`	Yes	Yes	Yes
`flow_type`	Yes	Yes	Yes
`purpose`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`beneficiary.first_name`	Yes	-	Yes
`beneficiary.last_name`	Yes	-	Yes
`beneficiary.business_name`	-	Yes	-
`beneficiary.phone`	Yes	Yes	Yes
`beneficiary.bank_account.account`	Yes	Yes	Yes
`remitter.first_name`	-	-	Yes
`remitter.last_name`	-	-	Yes
`remitter.document.id`	-	-	Yes
`remitter.address.country`	-	-	Yes

Wallet transfers

Wallet transfer parameters	B2C	B2B
`external_id`	Yes	Yes
`payment_method_id`	Yes	Yes
`flow_type`	Yes	Yes
`purpose`	Yes	Yes
`country`	Yes	Yes
`amount`	Yes	Yes
`currency`	Yes	Yes
`beneficiary.first_name`	Yes	-
`beneficiary.last_name`	Yes	-
`beneficiary.business_name`	-	Yes
`beneficiary.instant_payment.type`	Yes	Yes
`beneficiary.instant_payment.id`	Yes	Yes

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
`external_id`	Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method. For bank transfers, use `BANK_TRANSFER`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or `P2P` (Person to Person).
`purpose`	Payout purpose code. See purpose codes reference.
`country`	Country code. For Turkey, use `TR`.
`amount`	Payout amount in TRY. Use up to 2 decimal places.
`currency`	Source currency of the FX operation. For Turkey, use `TRY` or `USD`. Payouts are always paid in local currency to the beneficiary.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name`	Beneficiary's last name. Maximum 50 characters.
`beneficiary.business_name`	Beneficiary's business name. Mandatory only for B2B.
`beneficiary.phone`	Beneficiary's phone number. Maximum 20 characters.
`beneficiary.bank_account.account`	Beneficiary's bank account number. Maximum 26 characters (IBAN Format).
`remitter.first_name`	Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.document.id`	Remitter's identification number. Maximum 45 characters. Mandatory only for remittance (P2P).
`remitter.address.country`	Remitter's country code in ISO 3166-1 alpha-2 format. Mandatory only for remittance (P2P).

Example request

{
  "external_id": "1234567812345678b",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "TR",
  "amount": 2064.00,
  "currency": "TRY",
  "beneficiary": {
    "first_name": "RUDRAH",
    "last_name": "HASHIMI",
    "phone": "+902125551212",
    "bank_account": {
      "account": "TR180003200000000096867774"
    }
  }
}

{
  "external_id": "1234567812345680b",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2B",
  "purpose": "OTHER_SERVICES",
  "country": "TR",
  "amount": 5000.00,
  "currency": "TRY",
  "beneficiary": {
    "business_name": "Turkish Business Ltd",
    "phone": "+902125551213",
    "bank_account": {
      "account": "TR180003200000000096867774"
    }
  }
}

{
  "external_id": "1234567812345679p",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "P2P",
  "purpose": "REMITTANCES",
  "country": "TR",
  "amount": 1500.00,
  "currency": "TRY",
  "beneficiary": {
    "first_name": "RUDRAH",
    "last_name": "HASHIMI",
    "phone": "+902125551212",
    "bank_account": {
      "account": "TR180003200000000096867774"
    }
  },
  "remitter": {
    "first_name": "John",
    "last_name": "Doe",
    "document": {
      "id": "12345678901"
    },
    "address": {
      "country": "US"
    }
  }
}

Wallet transfers

Wallet transfers enable real-time transfers using a mobile phone number or a Papara number linked to a wallet.

The beneficiary.instant_payment.type field must indicate the type of wallet key being used (e.g., Papara Mobile, Papara Number). The beneficiary.instant_payment.id field must be present and correctly formatted.

Mandatory parameters

The table below outlines the required parameters for Wallet transfers.

Mandatory parameter	Description
`external_id`	Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method. For wallet transfers, use `INSTANT_PAYMENT`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer) or `B2B` (Business to Business).
`purpose`	Payout purpose code. See purpose codes reference.
`country`	Country code. For Turkey, use `TR`.
`amount`	Payout amount in `TRY`. Use up to 2 decimal places.
`currency`	Source currency of the FX operation. For Turkey, use `TRY` or `USD`. Payouts are always paid in local currency to the beneficiary.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name`	Beneficiary's last name. Maximum 50 characters.
`beneficiary.business_name`	Beneficiary's business name. Mandatory only for B2B.
`beneficiary.instant_payment.type`	Type of wallet being used: `papara_mobile`, `papara_number`.
`beneficiary.instant_payment.id`	Beneficiary's wallet identifier. Mobile phone number for `papara_mobile` or Papara number for `papara_number`. The mobile phone number can be sent either with 10 digits (e.g., 1234567890) or with the country code (+90) plus 10 digits (e.g., +901234567890). The Papara number can be sent either with 10 digits (e.g., 1234567890) or with a 2-character prefix (e.g., PL1234567890).

Example request

{
  "external_id": "1234567812345678w",
  "payment_method_id": "INSTANT_PAYMENT",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "TR",
  "amount": 2064.00,
  "currency": "TRY",
  "beneficiary": {
    "first_name": "RUDRAH",
    "last_name": "HASHIMI",
    "phone": "+902125551212",
    "instant_payment": {
      "type": "papara_mobile",
      "id": "+901234567890"
    }
  }

{
  "external_id": "1234567812345679w",
  "payment_method_id": "INSTANT_PAYMENT",
  "flow_type": "B2B",
  "purpose": "OTHER_SERVICES",
  "country": "TR",
  "amount": 3500.00,
  "currency": "TRY",
  "beneficiary": {
    "business_name": "Turkish Digital Company",
    "instant_payment": {
      "type": "papara_number",
      "id": "1234567890"
    }
  }
}

Bank information

Access the reference formats and accepted values required for processing bank payouts in Turkey.

Bank account validations

Validation	Type	Length	Type	Verification
Bank account	IBAN	26	Characters	IBAN algorithm