Türkiye divides into the payment service providers, which you can sign up to yourself, and the bank virtual POS, which your bank issues. TapTime supports both.
iyzico
Self-serve and quick. The API key identifies you and the secret signs every request, so both are needed.
-
1
Sign in to the iyzico merchant panel
Complete the merchant verification first — the live keys are not issued before it.
-
2
Open the settings section holding your API keys
You will see a sandbox pair and a live pair.
-
3
Copy the pair that matches your test switch
Sandbox keys with test mode on, live keys with it off.
| Field in TapTime | Where it comes from |
|---|---|
| API key | The iyzico merchant panel. |
| Secret key | Issued with it. Secret. |
PayTR
PayTR gives three values on one page of the merchant panel, and all three are needed — the key and the salt together are what make the hash valid.
| Field in TapTime | Where it comes from |
|---|---|
| Merchant ID | The merchant information page of the PayTR panel. |
| Merchant key | Same page. Secret. |
| Merchant salt | Same page. Secret. |
Craftgate
| Field in TapTime | Where it comes from |
|---|---|
| API key | The Craftgate merchant panel. |
| Secret key | Issued with it. Secret. |
Bank virtual POS (NestPay)
Most Turkish banks — and several in the western Balkans — run the same NestPay platform. One entry in TapTime serves all of them, because the difference between banks is only the host you are issued.
-
1
Ask your bank for a virtual POS
They issue the gateway host, a client id (which is your terminal) and a merchant panel login.
-
2
Set a store key in the bank's panel
You choose it. It is what signs the payment form, so treat it as a password.
-
3
Create an API user
A second login, used only to query the status of a payment. Give it the API role the bank offers.
-
4
Paste all five into TapTime
Host without https://, then the client id, store key, API user and its password.
| Field in TapTime | Where it comes from |
|---|---|
| Gateway host | Issued by your bank, e.g. the sanalpos host on your onboarding sheet. Hostname only. |
| Client ID (terminal) | Your terminal number from the bank. |
| Store key | Set by you in the bank's merchant panel. Secret. |
| API user name | The API login you created in that panel. |
| API password | Its password. Secret. |
Frequently asked
Which is cheaper, a PSP or a bank virtual POS?
A bank terminal is usually cheaper per transaction and slower to obtain; a PSP is the reverse. Many venues start on a PSP and move later.
Can I take instalments?
That depends on your merchant contract with the bank or PSP. Ask them what your terminal is enabled for.
My bank is not named in the list.
If it uses NestPay — most do — use the bank virtual POS entry with your own host. Ask the bank if you are unsure.
Thank you — that helps us make these guides better.
Write to us and quote the page you were on. A person reads every message and answers in the language you wrote in.
Write to us