Turquie : iyzico, PayTR, Craftgate et TPE virtuels bancaires

Deux clés d’API pour les indépendants, cinq champs pour un terminal bancaire NestPay — et l’hôte à saisir.

5 min de lecture Encaisser des paiements Mis à jour le 08.09.2026

La Turquie se partage entre les prestataires de services de paiement, auxquels vous pouvez vous inscrire vous-même, et les TPE virtuels bancaires, émis par votre banque. TapTime prend en charge les deux.

iyzico

En libre-service et rapide. La clé d’API vous identifie et le secret signe chaque requête : les deux sont nécessaires.

  1. 1
    Connectez-vous au panneau commerçant iyzico

    Terminez d’abord la vérification du commerçant — les clés de production ne sont pas émises avant.

  2. 2
    Ouvrez la section des paramètres contenant vos clés d’API

    Vous y verrez une paire sandbox et une paire de production.

  3. 3
    Copiez la paire qui correspond à votre interrupteur de test

    Les clés sandbox avec le mode test activé, les clés de production avec le mode test désactivé.

Champ dans TapTimeD’où il vient
API keyLe panneau commerçant iyzico.
Secret keyÉmise avec elle. Secrète.

PayTR

PayTR fournit trois valeurs sur une même page du panneau commerçant, et les trois sont nécessaires — c’est la clé et le sel ensemble qui rendent le hachage valide.

Champ dans TapTimeD’où il vient
Merchant IDLa page d’informations commerçant du panneau PayTR.
Merchant keyMême page. Secrète.
Merchant saltMême page. Secret.

Craftgate

Champ dans TapTimeD’où il vient
API keyLe panneau commerçant Craftgate.
Secret keyÉmise avec elle. Secrète.

TPE virtuel bancaire (NestPay)

La plupart des banques turques — et plusieurs dans les Balkans occidentaux — utilisent la même plateforme NestPay. Une seule entrée dans TapTime les couvre toutes, car d’une banque à l’autre seul l’hôte qui vous est attribué change.

  1. 1
    Demandez un TPE virtuel à votre banque

    Elle fournit l’hôte de la passerelle, un identifiant client (votre terminal) et un accès au panneau commerçant.

  2. 2
    Définissez une clé de boutique dans le panneau de la banque

    C’est vous qui la choisissez. Elle signe le formulaire de paiement : traitez-la comme un mot de passe.

  3. 3
    Créez un utilisateur API

    Un second identifiant de connexion, utilisé uniquement pour consulter le statut d’un paiement. Attribuez-lui le rôle API proposé par la banque.

  4. 4
    Collez les cinq valeurs dans TapTime

    L’hôte sans https://, puis l’identifiant client, la clé de boutique, l’utilisateur API et son mot de passe.

Champ dans TapTimeD’où il vient
Gateway hostFourni par votre banque, par exemple l’hôte sanalpos indiqué sur votre fiche d’ouverture. Le nom d’hôte uniquement.
Client ID (terminal)Votre numéro de terminal fourni par la banque.
Store keyDéfinie par vous dans le panneau commerçant de la banque. Secrète.
API user nameL’identifiant API que vous avez créé dans ce panneau.
API passwordSon mot de passe. Secret.

Questions fréquentes

Qu’est-ce qui revient le moins cher, un PSP ou un TPE virtuel bancaire ?

Un terminal bancaire est généralement moins cher par transaction mais plus long à obtenir ; c’est l’inverse pour un PSP. Beaucoup d’établissements commencent avec un PSP et changent plus tard.

Puis-je proposer le paiement en plusieurs fois ?

Cela dépend de votre contrat commerçant avec la banque ou le PSP. Demandez-leur pour quoi votre terminal est activé.

Ma banque n’est pas citée dans la liste.

Si elle utilise NestPay — c’est le cas de la plupart —, utilisez l’entrée TPE virtuel bancaire avec votre propre hôte. En cas de doute, renseignez-vous auprès de la banque.

Cet article vous a-t-il été utile ?
Cela n’a pas répondu à votre question ?

Écrivez-nous en indiquant la page sur laquelle vous étiez. Une vraie personne lit chaque message et répond dans la langue dans laquelle vous avez écrit.

Écrivez-nous