Demandes de paiement aux utilisateurs connectés

Si vos utilisateurs se connectent avec « Se connecter avec pismile », vous pouvez leur envoyer une demande de paiement à tout moment : une facture, un abonnement, une recharge. Ils la reçoivent dans leur application bancaire et la valident. Vous ne connaissez jamais leur alias : vous utilisez leur identifiant pismile (sub).

Comment ça marche#

1. L'utilisateur accepte, une fois

   À la connexion, votre application demande le scope pismile:payment. pismile affiche « Vous envoyer des demandes de paiement — rien n'est débité sans votre validation dans votre banque », et l'utilisateur choisit le compte qui recevra les demandes.

2. Votre serveur envoie une demande

   POST /api/v1/paiements avec le sub, le montant et votre référence.

3. L'utilisateur valide dans sa banque

   Il a 24 heures. La demande apparaît aussi dans son historique de l'application pismile.

4. Vous êtes prévenu

   Webhook paiement.paye (ou paiement.refuse, paiement.expire). L'argent est sur votre compte.

L'utilisateur peut à tout moment changer de compte ou retirer l'accès depuis son espace pismile (« Demandes de paiement »).

Prérequis#

• Tout ce qui est dans Préparer votre compte.

• Un plan Développeurs qui inclut le scope pismile:payment, et ce scope coché sur votre application.

1. Demander l'accord à la connexion#

Ajoutez pismile:payment aux scopes demandés :

import Pismile from "@pismile/authjs"

Pismile({ scope: "openid profile pismile:payment" })

spring.security.oauth2.client.registration.pismile.scope=openid,profile,pismile:payment

Gardez le sub de l'utilisateur (avec Auth.js : session.user.id).

2. Envoyer une demande#

const paiement = await pismile.paiements.creer({
  sub: utilisateur.pismileSub,
  montant: 5000,
  reference: "facture-2026-10-1042",
  motif: "Abonnement octobre",
})
paiement.statut   // "EN_ATTENTE"

Paiement p = pismile.paiements().creer(utilisateur.getPismileSub(), 5000,
        "facture-2026-10-1042", "Abonnement octobre");
p.statut();   // "EN_ATTENTE"

$p = $pismile->paiements()->creer($utilisateur['pismile_sub'], 5000,
    'facture-2026-10-1042', 'Abonnement octobre');
$p->statut;   // "EN_ATTENTE"

Le payeur voit dans sa banque : « Nom de votre application - Abonnement octobre ».

Statuts#

Limites#

Pour protéger vos utilisateurs contre les demandes abusives : 3 demandes en attente et 20 demandes par 24 heures, par utilisateur et par application.

Erreurs fréquentes#