Depuis 2013, PayPlug propose une infrastructure de paiement pensée pour les commerçants français, sans les couches de configuration d’un système e-commerce complet. C’est précisément ce qui en fait une solution pertinente pour un artisan menuisier qui ne vend jamais en ligne au sens classique : il envoie des devis, et demande un acompte de trente pour cent à la signature.
Installer WooCommerce pour un seul cas d’usage aussi ciblé serait disproportionné : catalogue, panier, gestion de stock, autant de concepts inutiles pour un devis qui se signe une fois puis génère un unique paiement d’acompte. La recette qui suit construit ce parcours avec un template dédié et l’API de PayPlug directement.
Le problème posé par l’artisan
Chaque devis signé doit générer une page de paiement d’acompte unique, avec le bon montant et la référence du devis, sans que le client n’ait à créer de compte ni à naviguer dans un catalogue de produits. Le montant varie à chaque devis, ce qui exclut un simple bouton de paiement à montant fixe.
Le snippet commenté
Un type de contenu personnalisé devis_acompte stocke le montant, la référence et le statut de paiement de chaque devis. Un template dédié single-devis_acompte.html affiche un bouton qui déclenche la création d’un paiement via l’API de PayPlug, avec le montant récupéré dynamiquement depuis la fiche du devis.
function creer_paiement_acompte( $devis_id ) {
$montant_centimes = (int) get_post_meta( $devis_id, 'montant_acompte', true ) * 100;
$reference = get_post_meta( $devis_id, 'reference_devis', true );
$reponse = wp_remote_post( 'https://api.payplug.com/v1/payments', array(
'headers' => array(
'Authorization' => 'Bearer ' . PAYPLUG_SECRET_KEY,
'Content-Type' => 'application/json',
),
'body' => wp_json_encode( array(
'amount' => $montant_centimes,
'currency' => 'EUR',
'metadata' => array( 'reference' => $reference ),
'hosted_payment' => array(
'return_url' => get_permalink( $devis_id ) . '?statut=merci',
),
'notification_url' => home_url( '/wp-json/artisan/v1/webhook-payplug' ),
) ),
) );
return json_decode( wp_remote_retrieve_body( $reponse ), true );
}
Confirmer le paiement par webhook, pas seulement par redirection
Se fier uniquement à l’URL de retour après paiement est une erreur classique : un client peut fermer l’onglet avant la redirection, laissant le devis en statut incertain. La confirmation fiable passe par le webhook de notification, enregistré comme route REST personnalisée qui met à jour le statut du devis dès réception du paiement confirmé côté serveur.
register_rest_route( 'artisan/v1', '/webhook-payplug', array(
'methods' => 'POST',
'callback' => function( WP_REST_Request $requete ) {
$donnees = $requete->get_json_params();
if ( 'paid' === $donnees['is_paid'] ) {
$devis_id = artisan_retrouver_devis_par_reference( $donnees['metadata']['reference'] );
update_post_meta( $devis_id, 'statut_acompte', 'regle' );
}
return new WP_REST_Response( array( 'ok' => true ), 200 );
},
'permission_callback' => '__return_true',
) );Variantes utiles
- Ajouter une relance automatique par courriel si l’acompte n’est pas réglé sous sept jours, via un événement planifié avec
wp_schedule_event(). - Générer un reçu PDF simple à l’aide d’une bibliothèque légère, déclenché depuis le même webhook une fois le paiement confirmé.
- Afficher un badge « acompte réglé » directement sur la fiche du devis dans l’administration, pour un suivi visuel rapide par l’artisan.
Ce que cette recette évite délibérément
Pas de gestion de panier, pas de compte client, pas de synchronisation de stock : uniquement un lien de paiement à montant variable, généré à la demande pour chaque devis. La facturation finale, une fois les travaux achevés, reste hors périmètre de cette recette et mérite un traitement distinct, potentiellement lié à un logiciel de facturation dédié.
Un artisan qui vend sur devis n’a pas besoin d’une boutique en ligne : il a besoin d’un lien de paiement fiable, au bon montant, au bon moment.
En résumé
Brancher PayPlug sur un template dédié à l’acompte, sans installer de système e-commerce complet, permet de répondre précisément au besoin d’un artisan qui vend sur devis. La clé de la fiabilité tient dans la confirmation par webhook plutôt que dans la seule redirection après paiement, un détail souvent négligé mais déterminant pour éviter les acomptes fantômes.
