SDK Javascript
Le SDK Javascript est conçu afin de permettre l'intégration de KKiaPay au sein de votre application web.
Quelque soit la technologie dont vous usez pour la réalisation de votre application web, le SDK Javascript est utilisable. Son intégration se fait en deux (02) étapes :
Toute utilisation du SDK de KKiaPay requiert un compte marchand valide. Si vous n'en disposez pas encore, créez-en un dès maintenant. L'intégration du SDK KKiaPay se fait en important le script qui suit avant la fermeture de la balise fermante</body>
:
Une fois le SDK importé dans votre application web, vous pouvez l'utiliser de diverses manières à savoir :
Avec un WebComponent ( Balise HTML)
En ajoutant une classe CSS sur votre bouton
Payer
En appelant le paiement depuis votre code Javascript
Si vous évoluez en mode test avec KKiaPay Sandbox, il vous faudra impérativement ajouter l'attribut sandbox et lui donner la valeur true afin de procéder à l'activation du mode test lors de la configuration du SDK. Dans ce cas, vous pouvez user des numéros de téléphone de test que vous offre KKiaPay afin de vous faire une idée de l'environnement live de KKiaPay.
1.Méthode du WebComponent
Il suffit d'ajouter le code ci-dessous dans votre code à l'emplacement souhaité pour votre bouton Payer
Remplacez les valeurs des attributs amount, key url et callback par les valeurs adéquates
Vous avez le choix !
Vous souhaitez autoriser un seul mode de paiement (Carte de crédit ou Mobile Money) sur votre interface KKiaPay ?
L'attribut paymentmethod vous permet de le faire. La valeur momo de cet attribut autorise le paiement via Mobile Money, comme seule méthode de paiement sur le widget KKiaPay, et sa valeur card le paiement via Carte Bancaire.
Vous disposez déjà d'un bouton Payer ? La méthode usant de la classe CSS est celle qu'il vous convient.
2. Méthode se basant sur la classe CSS
Elle requiert la modification du script importé dans votre page. Ajoutez-y les informations nécessaires en prenant comme exemple le snippet ci-dessous :
Rajoutez ensuite la classe kkiapay-button sur votre bouton html.
Vous pouvez changer la position du widget kkiapay en modifiant la valeur de l'attribut position = right|left|center
3. Depuis votre code Javascript.
Une fois le script importé dans votre code, la fonction openKkiapayWidget est automatiquement disponible dans le DOM. Vous pouvez de ce fait ouvrir la fenêtre de paiement en usant de la fonction qui suit :
Important!
Afin d'éviter toute fraude, procédez à la vérification côté serveur de l'opération de transaction. Pour cela, apprenez-en plus sur les SDKs Serveurs.
Vous pouvez souscrire aux événements liés à l'opération de paiement avec les fonctions :
Référence
Attribut
Type
Requis
Description
data
-
Non
Les informations liées à votre transaction
phone
String
Non
Numéro de téléphone du client (Si mobile money)
paymentmethod
-
Non
La méthode de paiement à autoriser sur le widget KKiaPay : momo | card
name
String
Non
Nom et prénoms du client
String
Non
L'email du client
theme
String
Non
La couleur que vous souhaitez pour le widget KKiaPay
key
String
Oui
Votre clé d'API publique
callback
String
Non
Le lien de redirection à la fin du paiement
position
String
Non
La position de votre widget sur votre site : left | right | center
amount
Number
Oui
Le montant à débiter au client
sandbox
Boolean
Non
La valeur true de cet attribut vous permet de passer en mode test
Response
La réponse obtenue est un objet Javascript contenant l'identifiant de la transaction.
Last updated