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	`document` name	`document` format	`document` required?
`TR`	`TRY`	T.C. Kimlik No.	Between 5 to 20 digits	Yes

Cards supported

`payment_method_id`	Brand ID	Name	`payment_method_type`	Details	Allowed Flows
`CARD`	`VI`	Visa	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`VD`	Visa Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`MC`	Mastercard	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`MD`	Mastercard Debit	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`AE`	American Express	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`MS`	Maestro	`CARD`	Debit Card	`DIRECT` `REDIRECT`
`CARD`	`DI`	Discover	`CARD`	Credit Card	`DIRECT` `REDIRECT`
`CARD`	`OT`	Troy	`CARD`	Credit Card	`DIRECT` `REDIRECT`

ℹ️
To offer all the card options that may be available in your integration, send the payment_method_id as CARD.

Alternative Payment Method supported

`payment_method_id`	Name	`payment_method_type`	Details	Allowed Flows	Logo
`SV`	Bank Transfer	`BANK_TRANSFER`	Bank Transfer	`REDIRECT`

Cards

Brands

Troy

The country’s first major domestic card scheme.

More than 20 Turkish banks are issuing a range of debit, credit, and prepaid Troy cards, which can be used at ATMs and point-of-sale terminals in Turkey and internationally through a co-badging arrangement with Discover Financial Services.

Capabilities

	Visa Credit	Visa Debit	Mastercard Credit	Mastercard Debit	American Express	Maestro	Discover	Troy
Minimum amount	1 TRY	1 TRY	1 TRY	1 TRY	1 TRY	1 TRY	1 TRY	1 TRY
Refunds	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Recurring	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Chargeback option	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Chargeback Dispute option	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
Descriptor	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name	Merchant name

How to process Card Payments?

Learn how to process payments with credit and debit cards with dLocal in our Card Payments section.

Alternative Payment Method

Bank Transfer

Bank Transfer is a payment method in Turkey that enables customers to transfer funds directly from their bank accounts to a merchant's static bank account number.

This method simplifies the payment process. The same account details are used for all transactions, eliminating the need for customers to receive new account information for each purchase.

Capabilities

	Bank Transfer
Min. amount	1 TRY
Max. expiration time supported	Configurable
Notification delay	Immediate
Refunds	Yes
Flow	`REDIRECT`

Request parameters

Property	Type	Description	Mandatory?
`amount`	Number	Amount to be charged.	Yes
`currency`	String	`TRY` Transaction currency in ISO 4217.	Yes
`country`	String	`TR` Transaction country in ISO 3166.	Yes
`payment_method_id`	String	`SV` ID of the selected payment method.	Yes
`payment_method_flow`	String	`REDIRECT`	Yes
`payer.name`	String	Name of the payer.	Yes
`payer.email`	String	Email of the payer.	Yes
`payer.document`	Number	Document of the payer.	No
`order_id`	Number	ID of the capture given by the merchant in their system. Think of it as an external ID of the capture.	No
`notification_url`	String	Notifications will be sent in every change of status of a payment to the `notification_url` specified by the merchant.	No

Examples

{
    "amount": 500,
    "currency": "TRY",
    "country": "TR",
    "payment_method_id": "SV",
    "payment_method_flow": "REDIRECT",
    "payer": {
        "name": "Jane Doe",
        "email": "janedoe@mymail.com",
        "document": "123456789",
        "address": {
            "country": "TR",
            "state": "Ankara",
            "city": "Ankara",
            "zip_code": "8858",
            "street": "Main St.",
            "number": "540"
        }
    },
    "order_id": "345453483kqws0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "callback_url": "http://merchantsite.com/success_page"
}

{
    "id": "R-4-f88efbc7-5tre-4ef8-uuj7-8cc41d0f3e47",
    "amount": 500,
    "currency": "TRY",
    "payment_method_id": "SV",
    "payment_method_type": "TICKET",
    "payment_method_flow": "REDIRECT",
    "country": "TR",
    "created_date": "2024-03-07T14:34:54.000+0000",
    "status": "PENDING",
    "status_detail": "The payment is pending.",
    "status_code": "100",
    "order_id": "345453483kqws0",
    "description": "Tshirt",
    "notification_url": "http://merchantsite.com/notification/new",
    "redirect_url": "https://pay.dlocal.com/gmf-apm/payments/M-88cfb343-fd54-4745-6yt5-e82673tya65b"
}

Example ticket

Bank Transfer UI built with the information in the example above.
Payers can choose from multiple destination banks.