Developer Center
PossaPay SDK
Intégrez le paiement multi-méthodes (Wallet, Carte, PayPal) en moins de 5 minutes avec notre SDK ultra-léger et sécurisé.
Portefeuille PossaPay
Cartes Bancaires (Stripe)
PayPal Integration
1. Installation
Ajoutez simplement notre script SDK dans la section <head> de votre page HTML. Aucune installation NPM requise, profitez d'une mise à jour automatique.
<script src="https://possapay.com/sdk/possapay.js"></script>2. Initialisation du bouton
Créez un conteneur vide et utilisez l'objet PossaPay pour générer un bouton de paiement premium hautement personnalisable.
// Initialisation du bouton de paiement
PossaPay.createButton({
containerId: "possa-btn-container",
publicKey: "VOTRE_CLE_PUBLIQUE",
amount: "5000",
currency: "XAF",
label: "Payer avec PossaPay",
description: "Achat Article #123",
customerEmail: "client@example.com",
callbackUrl: "https://votre-site.com/succes"
});3. Écoute des résultats
Le SDK communique avec votre site parent via postMessage. Écoutez ces événements pour savoir si le paiement a été validé.
// Écouter le résultat du paiement
window.addEventListener('message', function(event) {
if (event.data.type === 'POSSAPAY_PAYMENT_RESULT') {
const { status, amount, reference } = event.data;
if (status === 'SUCCESS') {
alert('Paiement réussi ! Réf: ' + reference);
// Rediriger ou mettre à jour l'UI
} else {
alert('Le paiement a échoué ou a été annulé.');
}
}
});Options disponibles
| Propriété | Type | Requis | Description |
|---|---|---|---|
| containerId | String | Oui | ID de l'élément HTML où afficher le bouton. |
| publicKey | String | Oui | Votre clé publique disponible dans le tableau de bord. |
| amount | Number/String | Oui | Montant de la transaction. |
| currency | String | Non | Devise ISO (XAF, EUR, USD). Par défaut: XAF. |
| callbackUrl | String | Oui | URL de retour après le paiement réussi. |
| customerEmail | String | Oui | Email du client pour la facturation. |
Besoin d'aide supplémentaire ?
Notre équipe technique est disponible pour vous accompagner dans votre intégration sur mesure.