SDK Mobiles (Public Keys Only)

Nos SDK mobiles sont conçus pour être utilisés exclusivement avec vos Clés Publiques (pk_...). Pour des raisons de sécurité, toute opération sensible (création de paiement) doit être effectuée sur votre backend.

React Native

Prompt d'Intégration IA (React Native)

Si vous utilisez un assistant IA (comme Cursor, GitHub Copilot, ChatGPT, Claude, etc.), vous pouvez copier-coller le prompt suivant pour intégrer ce SDK de A à Z dans votre projet :

Agis en tant qu'expert React Native. Je souhaite intégrer le SDK React Native de HayBTech (`@haybtech/react-native`) pour intégrer la passerelle de paiement dans mon application mobile de A à Z.

Voici ma stack technique actuelle :
- Framework : [ex: Expo, React Native CLI]
- State Management : [ex: Redux Toolkit, Zustand, Context API]

*Note de sécurité : L'initiation se fait via le serveur marchand backend pour protéger les clés secrètes.*

Tâches à accomplir dans le code généré :
1. **Appel API Backend** : Coder la requête réseau (Axios ou Fetch) pour appeler mon backend (en lui passant les informations de commande) et récupérer la session de paiement.
2. **Composant Checkout** : Créer un écran ou modal utilisant `react-native-webview` (ou le composant officiel du SDK) pour charger l'URL de paiement HayBTech de manière fluide.
3. **Capture des événements de navigation (Navigation State Change)** : Intercepter les redirections du WebView vers les URLs de succès et d'échec pour fermer la modale de paiement et naviguer vers les écrans correspondants de mon application.
4. **Vérification de sécurité** : Interroger mon backend après la transaction pour s'assurer que le webhook a bien validé la transaction avant d'attribuer le produit à l'utilisateur.

Génère du code TypeScript propre, moderne, commenté et fonctionnel.

Installation

npm install @haybtech/react-native

Usage

import { Checkout } from '@haybtech/react-native';

<Checkout 
  paymentUrl={urlGenereeParVotreBackend}
  onSuccess={() => alert("Succès !")}
/>

Flutter

Prompt d'Intégration IA (Flutter)

Si vous utilisez un assistant IA (comme Cursor, GitHub Copilot, ChatGPT, Claude, etc.), vous pouvez copier-coller le prompt suivant pour intégrer ce SDK de A à Z dans votre projet :

Agis en tant qu'expert Flutter. Je souhaite intégrer le SDK Flutter de HayBTech (`haybtech_flutter_sdk`) dans mon application mobile multiplateforme pour gérer le parcours de paiement de A à Z.

Voici ma stack technique :
- State Management : [ex: Riverpod, Provider, Bloc, GetX]
- Client HTTP : [ex: Dio, http]

*Note de sécurité : L'initiation se fait via le serveur marchand backend. L'application mobile récupère l'URL de paiement pour la présenter.*

Tâches à accomplir dans le code généré :
1. **Intégration du flux** : Écrire le service réseau pour demander la création du paiement à mon serveur backend (en lui passant les informations de commande) et récupérer `payment_url`.
2. **Affichage du Checkout** : Implémenter l'affichage du WebView ou de la page de paiement sécurisée de manière intégrée dans l'application avec le widget `HayBTechCheckout` en fournissant les callbacks `onSuccess`, `onCancel` et `onFailure`.
3. **Gestion des redirections de retour** : Détecter dans l'URL du WebView la présence des URLs de succès ou d'échec pour fermer automatiquement le guichet de paiement et rediriger l'utilisateur vers le bon écran de l'application Flutter.
4. **Synchronisation finale** : Écrire la logique pour rafraîchir le statut de l'utilisateur avec mon backend après la fermeture du WebView.

Génère le code Dart structuré, réutilisable, commenté et optimisé.

Installation

dependencies:
  haybtech_flutter_sdk: ^1.0.0

Usage

import 'package:haybtech_flutter_sdk/haybtech_flutter_sdk.dart';

HayBTechCheckout(
  paymentUrl: urlGenereeParVotreBackend,
  onSuccess: (url) => print("Succès"),
)

iOS (Swift)

WARNING

Ce SDK est actuellement en cours de développement (bêta publique).

Prompt d'Intégration IA (iOS Swift)

Si vous utilisez un assistant IA (comme Cursor, GitHub Copilot, ChatGPT, Claude, etc.), vous pouvez copier-coller le prompt suivant pour intégrer ce SDK de A à Z dans votre projet :

Agis en tant qu'expert en développement iOS. Je souhaite intégrer le SDK iOS de HayBTech (`HayBTechSDK`) dans mon application mobile native pour permettre aux utilisateurs de payer de A à Z.

Voici ma stack technique actuelle :
- Interface utilisateur : [ex: SwiftUI, UIKit]
- Gestion de l'état : [ex: @StateObject, Combine, Swift Concurrency]
- Backend : [ex: Mon backend propre en Node.js, ou intégration directe si applicable]

*Note de sécurité : Pour des raisons de sécurité, l'initiation du paiement doit toujours se faire via mon serveur backend pour ne pas exposer la clé secrète dans l'application mobile. Le SDK iOS sert à présenter l'interface ou gérer le flux de redirection/retour dans l'application.*

Tâches à accomplir dans le code généré :
1. **Appel de Checkout Backend** : Implémenter la fonction réseau qui appelle mon serveur backend `/api/checkout` pour générer une transaction et récupérer la `payment_url`.
2. **Affichage du Guichet de Paiement** : Implémenter le composant SwiftUI (ou UIKit) (ex: en utilisant `WebKit / WKWebView` ou le contrôleur du SDK) pour afficher la page de paiement.
3. **Gestion des callbacks de retour (Deep Linking)** : Configurer le comportement de l'application lorsque le paiement est terminé et que l'utilisateur clique sur le bouton de retour (gestion des URLs de type `monapp://success` ou `monapp://cancel`).
4. **Validation de l'état final** : Effectuer un appel de vérification vers mon serveur backend sur le statut final de la transaction pour s'assurer que le paiement a bien été validé avant de débloquer le contenu dans l'application mobile.

Génère le code Swift moderne et les configurations nécessaires de A à Z.

Installation (SPM)

URL : https://github.com/haybtech/ios-sdk

Usage

import HayBTechSDK

HayBTechCheckoutView(
    paymentUrl: urlGenereeParVotreBackend,
    onSuccess: { _ in print("Succès") }
)

Android (Kotlin)

WARNING

Ce SDK est actuellement en cours de développement (bêta publique).

Prompt d'Intégration IA (Android Kotlin)

Si vous utilisez un assistant IA (comme Cursor, GitHub Copilot, ChatGPT, Claude, etc.), vous pouvez copier-coller le prompt suivant pour intégrer ce SDK de A à Z dans votre projet :

Agis en tant qu'expert en développement Android natif. Je souhaite intégrer le SDK Android de HayBTech (`sn.haybtech:sdk`) dans mon application mobile pour gérer le parcours de paiement des clients de A à Z.

Voici ma stack technique actuelle :
- UI Framework : [ex: Jetpack Compose, XML Views]
- Concurrency / Réseau : [ex: Kotlin Coroutines, Retrofit]

*Note de sécurité : L'initiation de paiement doit se faire côté serveur. Le SDK Android sert à afficher le flux de paiement de manière sécurisée et à intercepter le résultat.*

Tâches à accomplir dans le code généré :
1. **Initiation réseau** : Créer le code réseau Retrofit pour appeler mon backend et récupérer la `payment_url`.
2. **Composant UI de paiement** : Créer un composant (Jetpack Compose ou Activity avec Custom Tab/WebView) pour afficher de manière optimale l'interface de paiement HayBTech.
3. **Gestion du cycle de vie et retour** : Gérer proprement la navigation lors des redirections de succès ou d'annulation. Gérer les Deep Links (`monapp://haybtech-callback`) pour revenir à l'application.
4. **Vérification finale** : Écrire la fonction de synchronisation avec mon serveur backend pour récupérer le statut validé par webhook avant de confirmer visuellement l'achat à l'utilisateur.

Génère du code Kotlin propre, moderne, commenté et prêt à l'intégration.

Installation

implementation 'sn.haybtech:sdk:1.0.0'

Usage

import sn.haybtech.sdk.HayBTech

HayBTech.checkout(context, urlGenereeParVotreBackend)

Sécurité Mobile

• Protection contre le reverse-engineering : Le SDK bloque l'utilisation des clés secrètes (sk_...).
• Isolation WKWebView/WebView : Aucune donnée bancaire ne transite par le code natif de l'application.
• Workflow sécurisé : L'application n'est qu'une interface de rendu pour une transaction scellée sur votre serveur.