Turkish Local Acquiring
FastSpring supports TROY cards as a payment method from Türkiye.
Turkish local acquiring is available to a limited number of sellers and is not enabled by default. Contact FastSpring Support to request it for your store.
TROY gives buyers in Türkiye a secure, convenient, and local way to pay with Türkiye's domestic card network. FastSpring processes TROY payments through a local Turkish acquirer for one-time and subscription purchases in TRY (Turkish lira).
The sections below explain the availability, buyer flow, and technical details for Turkish local acquiring. Select a section or use the TOC on the right to jump ahead.
Prerequisites
To use a TROY card for payment, the following requirements must be met:
- The buyer must complete checkout with Türkiye set as the country.
- The transaction must use TRY (Turkish lira) as the currency.
- The buyer must enter valid TROY credit or debit card details.
Note: FastSpring determines eligibility by checking the buyer's checkout country, currency, and card brand. When the country and currency are set to Türkiye/TRY and the card is TROY, we process the card locally. Any other combination is processed cross-border.
Customer experience
Here is the FastSpring TROY experience for buyers:
- The buyer selects Credit / Debit Card as their payment option during checkout and enters their TROY card details.
- The buyer completes 3-D Secure authentication, usually with a one-time SMS code from their bank.
- The buyer completes payment in TRY.
- FastSpring displays a completed order confirmation.
Note: Turkish local acquiring doesn't add a transaction levy for the buyer. As merchant of record, FastSpring handles Turkish VAT (KDV) through its standard tax process.
Warning: Installment payments (taksit) are not supported at launch. Buyers pay the full amount in a single charge.
Refunds and returns
Refunds for TROY transactions behave the same as other FastSpring refunds. Refunds are only available on completed orders, and both full and partial refunds are supported. FastSpring returns the funds to the buyer's original card in TRY.
Webhooks
FastSpring includes the following fields in the order.completed webhook payload when an order is completed with a TROY card:
"payment": {
"type": "creditcard",
"creditcard": "troy",
"cardEnding": "7314"
}The supported value for the creditcard field is troy.
For more information on the order.completed webhook, see the Successful Orders documentation.
FAQs
Can TROY be used for subscription purchases?
Yes. TROY cards can be used for one-time purchases, manual renewals, and automatic renewals. FastSpring saves the card securely so it can be used for renewal charges and 1-Click purchases.
Is TROY enabled by default?
No. TROY is not automatically enabled for all FastSpring sellers. To request it, contact FastSpring Support.
Is TROY a real-time payment method?
Yes. TROY payments are processed in real-time.
Which card brands are supported?
Buyers in Türkiye can pay with Visa, Mastercard, or TROY. Only TROY cards are processed locally; all other card brands are processed cross-border.
Is there an extra fee for the buyer?
No. Turkish local acquiring doesn't add a fee or transaction levy for the buyer.
Are installments (taksit) supported?
No. Installment payments are not supported at launch.
What happens if a buyer in Türkiye checks out in USD or EUR?
The payment is processed cross-border. Local processing applies only when the country is Türkiye, the currency is TRY, and the card is TROY.
Updated about 4 hours ago