FAQ

Compte et onboarding

Combien de temps prend la création d'un compte ?

Inscription : quelques minutes. La validation du dossier KYC est communiquée une fois le dossier complet déposé (NINEA, RC, pièce ID gérant, RIB).

Quels documents pour le KYC ?

Trois niveaux progressifs de vérification, déterminant le type d'opérations autorisées :

Niveau	Documents
1	Téléphone vérifié
2	Niveau 1 + pièce ID + selfie
3	Niveau 2 + RIB + justificatif de domicile

Les plafonds appliqués à chaque niveau sont affichés dans votre dashboard après activation du compte.

Mon dossier KYC est rejeté, que faire ?

Le dashboard affiche le motif. Re-soumettez les pièces corrigées dans la section KYC. Pas de pénalité, pas de temps de carence.

Tarification

Combien coûte HayBTech ?

Les frais et conditions commerciales sont détaillés dans votre contrat marchand et consultables depuis les paramètres de votre Dashboard.

Quand suis-je payé ?

Le cycle de reversement dépend du canal de paiement utilisé. Les délais effectifs par canal sont consultables dans votre dashboard.

Vous pouvez configurer un seuil minimum de reversement dans le dashboard.

Technique

Pourquoi Idempotency-Key est obligatoire ?

Pour éviter le double-débit en cas de timeout réseau. Sans cette clé, un retry crée une seconde transaction. Voir Idempotency.

Le webhook doit-il répondre quoi ?

2xx (n'importe lequel) sous quelques secondes. Le body est ignoré. Tout autre code, ou un timeout, déclenche un retry.

Combien de retries pour un webhook ?

Plusieurs tentatives sur plusieurs jours avec backoff exponentiel. Après un certain nombre d'échecs consécutifs, l'endpoint est auto-suspendu et un email vous est envoyé.

Comment renvoyer un webhook manuellement ?

Dashboard -> Webhooks -> Logs -> cliquer Resend sur la ligne souhaitée.

Puis-je avoir plusieurs endpoints webhook ?

Oui. Chaque endpoint a son propre secret et son propre filtre d'événements.

Que se passe-t-il si je perds mon secret webhook ?

Vous ne pouvez pas le récupérer (HayBTech n'en stocke que le hash). Faites une rotation via le dashboard. Le nouveau secret est affiché une seule fois.

pk_test_... et pk_live_... voient-ils les mêmes données ?

Non. Chaque clé voit uniquement les objets de son livemode. Une clé test ne peut pas accéder à un objet live et inversement (livemode_mismatch).

Puis-je rejouer une transaction de test en production ?

Non. Les merchant_ref peuvent être identiques entre mode test et mode live (clé d'unicité scopée par livemode), mais les identifiants HayBTech sont distincts et ne se croisent jamais.

Cas métier

Comment intégrer un Hosted Checkout sans backend ?

Créez un Payment Link via le dashboard. L'URL est partageable directement (WhatsApp, SMS, email).

Puis-je faire payer en EUR un client sénégalais ?

Oui. La devise du paiement est indépendante de la devise de reversement. Le taux de change est gelé à l'initiation.

Combien de splits par transaction ?

Plusieurs bénéficiaires sont supportés. Pour un grand nombre de bénéficiaires, contactez le support pour optimiser la performance.

Puis-je rembourser un paiement mobile money ?

Certains canaux mobile money n'ouvrent pas de remboursement automatique côté provider. Dans ce cas, le remboursement passe par un transfert sortant vers le numéro du payeur. Les cartes supportent le remboursement automatique.

Puis-je créer un abonnement payé en mobile money ?

Oui, à condition de disposer d'un moyen de paiement enregistré (moyen tokenisé). Les moyens tokenisés en mobile money sénégalais arrivent progressivement avec les opérateurs. En attendant, les abonnements peuvent s'exécuter par un envoi manuel du payeur à chaque cycle.

Comment résilier un abonnement ?

DELETE /v1/subscriptions/{id} (immédiat) ou ?at_period_end=true (différé à la fin du cycle courant).

Conformité

HayBTech est-il réglementé ?

HayBTech opère dans le cadre réglementaire applicable aux prestataires de services de paiement au Sénégal. Les documents d'habilitation en cours sont communiqués à la demande des marchands institutionnels.

Les fonds des marchands sont-ils protégés ?

Les fonds en attente de reversement sont tracés dans des comptes dédiés distincts des fonds de fonctionnement de la société, conformément aux pratiques des prestataires de services de paiement.

HayBTech stocke-t-il mes mots de passe Wave ou Orange Money ?

Non. HayBTech utilise des API marchand (clés API dédiées par canal), jamais les identifiants de votre payeur.

Aide

Comment contacter le support ?

• Email : support@haybtech.com
• Chat dashboard : disponible aux heures de bureau