Wave

Le client choisit son service, le site ouvre une commande à son nom avec une référence unique, puis l’envoie payer chez Wave. Le service ne s’ouvre que lorsque Wave confirme l’encaissement au serveur : un client qui revient sur le site ne déverrouille rien par lui-même.

Configuration Wave

La clé d’API et le secret de webhook restent sur le serveur : cette page les reçoit seulement sous la forme « présente, quatre derniers caractères ». Elle ne peut jamais les relire. L’emplacement recommandé n’est d’ailleurs pas cette page mais les variables d’environnement du site, WAVE_API_KEY et WAVE_WEBHOOK_SECRET : quand elles existent, elles ont la priorité sur ce qui est saisi ici.

Paiement Wave par commande

Environnement de paiement

Devise transmise à Wave code ISO 4217

Lien de paiement du marchand

Le lien de votre compte Wave, sans montant. Le montant est porté par la commande, d’après le barème du service choisi : un montant inscrit dans le lien serait refusé à l’enregistrement.

Lien Wave https://pay.wave.com/…

Confirmation automatique

À déclarer dans votre portail Wave comme adresse de notification. C’est par elle que Wave annonce un paiement abouti ; sa signature est vérifiée avec le secret de webhook, et une notification reçue deux fois ne déverrouille qu’une fois.

Adresse du webhook

Secrets

Laissez ces champs vides pour ne rien changer. Ce qui est saisi remplace ce qui est en place ; rien de ce qui est en place ne redescend jusqu’ici.

Clé d’API Wave —

Secret de webhook —

Retour du client

Les deux pages du site où Wave renvoie le client, selon que le paiement a abouti ou non. Ce retour ne prouve rien : il ne fait que ramener la personne sur son rapport pendant que la confirmation se règle entre Wave et le serveur.

Retour après paiement

Retour après échec

Paiements Wave

0commandes

0en attente

0payées

0échouées

0annulées

0encaissés

Client	Référence	Service	Montant	Statut	Date	Transaction	Actions

« Rapprocher » redemande à Wave où en est la session de paiement, et n’applique que sa réponse : c’est le seul geste de cette page qui puisse aboutir à un déverrouillage, et seulement si Wave confirme l’encaissement du montant dû. Le statut « payée » ne se pose pas à la main. « Annuler » referme une commande restée sans paiement ; une commande payée ne s’annule pas ici.

Journal des événements de paiement

Chaque commande ouverte, chaque notification reçue, chaque signature refusée et chaque rapprochement laisse une ligne ici. C’est la pièce à produire en cas de litige, et c’est aussi ce qui empêche un même événement d’être traité deux fois.

Moment	Origine	Événement	Référence	Résultat	Détail

Accès réservé à l’administrateur