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éTypeRequisDescription
containerIdStringOuiID de l'élément HTML où afficher le bouton.
publicKeyStringOuiVotre clé publique disponible dans le tableau de bord.
amountNumber/StringOuiMontant de la transaction.
currencyStringNonDevise ISO (XAF, EUR, USD). Par défaut: XAF.
callbackUrlStringOuiURL de retour après le paiement réussi.
customerEmailStringOuiEmail du client pour la facturation.

Besoin d'aide supplémentaire ?

Notre équipe technique est disponible pour vous accompagner dans votre intégration sur mesure.

Contacter le support