FAQ
Do I handle card data?
Section titled “Do I handle card data?”No. Customers enter card details on TurnStay’s PCI-compliant hosted page. You never see card numbers.
Do I need to implement 3D Secure?
Section titled “Do I need to implement 3D Secure?”No. TurnStay handles 3DS automatically on the hosted payment page. The customer completes the 3DS challenge within TurnStay’s page, and you receive the final result via callback.
What’s the minimum data I need to send?
Section titled “What’s the minimum data I need to send?”Four fields: account_id, billing_amount, billing_currency, and checkin_date. We strongly recommend also sending merchant_reference, callback_url, and success_redirect_url.
We currently send a reference, amount, and currency. Is that enough?
Section titled “We currently send a reference, amount, and currency. Is that enough?”Yes. Map your fields to TurnStay:
| Your field | TurnStay field |
|---|---|
| Reference | merchant_reference |
| Amount | billing_amount (multiply by 100 for cents) |
| Currency | billing_currency |
Add account_id and checkin_date, and you’re set.
What if the customer has a foreign card?
Section titled “What if the customer has a foreign card?”No issue. You bill in your currency. TurnStay auto-converts and settles in your currency. A French customer with a EUR card paying for a ZAR booking will be charged in EUR, and you receive the full ZAR amount.
What happens if payment fails?
Section titled “What happens if payment fails?”The customer sees an error and can retry. If they give up, they go to failed_redirect_url. Your server receives status: "failed" via callback.
What languages/frameworks are supported?
Section titled “What languages/frameworks are supported?”Any language that makes HTTP requests. The documentation includes cURL, Python, and Node.js examples. C# examples are available in the Merchant Integration Guide PDF.
How do I get API keys?
Section titled “How do I get API keys?”Book a demo to get your API keys and dashboard access. Or contact support.
Where can I get help?
Section titled “Where can I get help?”| Channel | Link |
|---|---|
| Book a demo | turnstay.com/cta |
| Contact us | turnstay.com/contact-us |
| Help center | intercom.help/turn-stay/en |
| Live chat | Available inside your TurnStay Dashboard |