Procédure

La génération d'un lien de paiement Virement Classique se fait selon les étapes suivantes :

1. Générer un access token
2. Créer une session de paiement et rediriger le payeur vers cette URL
3. Vérifier le paiement lors du callback afin que le statut du paiement et l'ID de session correspondent
4. Écouter le webhook pour être notifié des changements de statut de paiement

Statuts de paiement

Vous trouverez ci-dessous le détail des statuts de paiement rencontrés en cas de paiement par Virement Classique.

💡 Pour faciliter la reproduction de certains scénarios en test, retrouvez ici notre documentation dédiée.

💡 Pour plus d'informations concernant nos statuts de paiement, retrouvez ici notre documentation dédiée.

Objet de réconciliation

L'objet de réconciliation vous permet de spécifier vos choix de réconciliation.

Cet objet se trouve dans la section meta des requêtes de paiement.

Par défaut, la réconciliation est effectuée au niveau de l'adresse mail du payeur. Des mais vous pouvez personnaliser ce paramètre :

• level : il s'agit de la valeur de départ pour générer un IBAN virtuel. Comme indiqué précédemment, la réconciliation est effectuée par défaut au niveau du payeur (payer), mais vous pouvez également choisir de l'effectuer via une clé personnalisée (key) ou par session de paiement (payment_session).
• key : clé personnalisée à utiliser pour la réconciliation
• match_amount : à utiliser uniquement si la réconciliation est effectuée par session de paiement. Si la valeur est définie sur « true », le rapprochement ne sera effectué que si le montant correspond.

Vous pouvez également récupérer l'IBAN virtuel dans le payloadsi vous souhaitez l'enregistrer ou l'inclure dans une facture en incluant le paramètre suivant en query:

• with_virtualbeneficiary : renvoie l'IBAN virtuel dans la réponse. La valeur est « true » ou « false » (la valeur par défaut est « false »).

Dans l'exemple ci-dessous, {payment_endpoint} peut prendre deux valeurs :

• connect : si le mode de paiement est utilisé lors d'un paiement en ligne ;
• request-to-pay : si le mode de paiement est inclus dans un lien de paiement, que ce soit pour un paiement physique ou par e-mail, SMS ou QR code.

POST /pis/v2/{payment_endpoint}?redirect_uri=[redirect_uri] HTTP/1.1
Authorization: Bearer [access_token]
Signature: [signature]
Digest: [digest]
Date: [date]
x-request-id: [request_id]
Accept: application/json
Content-Type: application/json
{ 
    "meta": {
        (...)
        "reconciliation": {
            "level": "key",
            "key": "my_key"
        }
    },
    "data": {
        (...)
    }
}