Canaux de paiement
Où dans l'administration : Finance › Payment channels (
/payments). Commutateurs et frais : Finance › Payment channels › Fees & limits (/payments/fees).
NexCMP utilise un solde USD prépayé. Les clients ajoutent des fonds au solde via un canal de paiement, puis chaque service est réglé depuis ce solde. Un canal n'est affiché aux clients que lorsqu'il est à la fois activé et configuré.
Description
Les canaux de paiement connectent vos comptes de paiement (Stripe, PayPal, Binance, une banque vietnamienne) au solde client. Un paiement confirmé génère exactement un crédit de solde — chaque crédit est identifié par l'ID de paiement de la passerelle, de sorte qu'un webhook répété ne peut jamais créditer deux fois. Utilisez cette page pour voir quels canaux sont prêts, leurs performances sur les 30 derniers jours et ceux qui nécessitent une attention particulière.
Prérequis
| Élément | Prérequis |
|---|---|
| Adresse HTTPS publique | Les passerelles envoient des webhooks vers https://<domain>/v1/billing/..., votre panneau doit donc être accessible depuis Internet via un protocole TLS valide (voir DNS and Cloudflare). |
| Comptes | Votre propre compte auprès de chaque fournisseur que vous souhaitez utiliser. Les identifiants sont saisis dans l'administration et ne sont plus jamais affichés (seuls les 4 derniers caractères le sont). |
| Rôle administrateur | Un compte administrateur. |
| Dépendances | Aucun. Le canal bancaire vietnamien nécessite en plus un taux de change. |
Les canaux
| Canal | Ce que voit le client | Configurer dans | Article |
|---|---|---|---|
| Carte (Stripe) | Formulaire de carte, carte enregistrée | Payment channels › Stripe | Stripe |
| Apple Pay, Google Pay, Link | Boutons de portefeuille (Stripe Express Checkout) | Stripe, plus enregistrement du domaine | Stripe |
| Alipay | Redirection vers Alipay (facturé en JPY par Stripe) | Stripe, plus frais et limites | Stripe |
| PayPal | Boutons PayPal, compte PayPal enregistré | Payment channels › PayPal | PayPal |
| USDT | Adresse de dépôt et montant exact | Payment channels › USDT | USDT |
| Virement bancaire VN | QR code et détails du virement (interface vietnamienne uniquement) | Payment channels › VN bank transfer | Virement bancaire (Vietnam) |
Préparer l'infrastructure
Non requis. Tout est configuré dans l'administration ; il n'y a rien à installer sur le serveur.
Connecter dans NexCMP
- Ouvrez Finance › Payment channels (
/payments). Le tableau de synthèse liste chaque canal avec son état. - Ouvrez l'onglet propre au canal (Stripe, PayPal, USDT, VN bank transfer) et suivez son article. Chaque onglet se termine par un bouton Save et, le cas échéant, un bouton Test.
- Ouvrez Fees & limits (
/payments/fees), recherchez la carte Payment gateways & fees (wallet top-up), activez le canal avec son interrupteur et cliquez sur Save channels & fees.
Interrupteurs et frais (Fees & limits)
| Paramètre | Valeur par défaut | Description |
|---|---|---|
| Carte (Stripe) | On | Formulaire de carte sur l'écran de dépôt. Masqué tant que Stripe ne dispose pas d'une clé secrète. |
| Apple Pay, Google Pay, Link | On | Boutons de portefeuille. Ils n'apparaissent que lorsque le domaine est vérifié chez Stripe. |
| Alipay | Désactivé | Nécessite qu'Alipay soit activé dans le tableau de bord Stripe. |
| PayPal | Désactivé | Affiché uniquement lorsque PayPal est configuré. |
| USDT (Binance) | Désactivé | L'interrupteur est verrouillé tant que l'adresse de dépôt n'a pas été vérifiée auprès de Binance. |
| Frais Stripe % / fixe (centimes) | 3.6 % et 0 | Utilisé pour afficher les frais au client et calculer le montant crédité. Définissez-le selon votre tarif Stripe réel. |
| Frais PayPal % / fixe | 4.4 % et 30 cents | Idem, pour PayPal. |
| Frais USDT % | 1 % | Idem, pour USDT. |
| Le client paie les frais de rechargement | Désactivé | On : le client paie le montant + les frais et le portefeuille reçoit le montant total. Off : les frais sont déduits et le portefeuille reçoit le montant moins les frais. |
Le client voit toujours les frais et le crédit final sur son portefeuille avant de payer. Désactiver un canal masque le bouton et le serveur refuse les nouveaux paiements avec method_disabled (HTTP 403).
Limites de rechargement
Le montant minimum et maximum par rechargement se trouvent sur la même page — voir Minimum top-up.
Vérification
- Dans le tableau récapitulatif, le canal affiche Enabled et Configured ; la colonne Last test est remplie après avoir cliqué sur Test dans l'onglet du canal.
- Connectez-vous au portail en tant que client test et ouvrez Billing › Deposit. Le bouton du canal est présent.
- Effectuez un petit paiement (consultez l'article du canal pour les cartes de test ou les comptes sandbox). Le solde augmente, une notification Top-up received apparaît et le paiement est répertorié dans Finance › Billing › Top-ups (
/billing/deposits).
Limites et notes
- Colonnes du récapitulatif : 30 days (nombre de paiements, réussites, échecs et volume), Stuck 24h (paiements toujours en attente après un jour) et Unmatched (USDT ou virements bancaires reçus mais ne correspondant à aucune commande). La ligne des KPI ajoute le volume sur 30 jours, le nombre de canaux défectueux (activés mais non configurés, ou paiements bloqués) et le total non concordant.
- Les événements de webhook sont répertoriés sous Payment channels › Gateway events (
/payments/events). Stripe possède son propre onglet ; PayPal et USDT en partagent un. Un événement échoué peut être rejoué — le grand livre du portefeuille est idempotent, le rejeu ne crédite donc jamais deux fois. - Les Resellers peuvent avoir leurs propres canaux Stripe, PayPal, USDT et bancaires. Leurs lignes apparaissent également ici, et le sélecteur de site dans l'en-tête les filtre. Voir Resellers.
- Remboursements : les paiements Stripe et PayPal peuvent être remboursés depuis la liste des paiements ; les paiements USDT ne peuvent pas être remboursés vers la source (le serveur répond
usdt_no_refund). - Le mode maintenance accepte toujours les webhooks de la passerelle, de sorte qu'un paiement effectué juste avant la maintenance n'est pas perdu.
Dépannage
| Symptôme | Cause | Solution |
|---|---|---|
| Canal manquant sur l'écran de dépôt du client | Désactivé, non configuré ou (banque VN) l'interface n'est pas en vietnamien | Vérifiez Fees & limits et l'onglet du canal ; voir Bank transfer (Vietnam). |
| Le KPI Faulty channels est supérieur à 0 | Un canal est activé sans identifiants, ou des paiements sont en attente depuis plus de 24 heures | Ouvrez la ligne et cliquez sur Configure ; pour les paiements bloqués, ouvrez Gateway events et rejouez-les. |
| Le client a payé mais le solde n'a pas changé | Le webhook n'est pas arrivé | Vérifiez l'URL du webhook dans l'onglet du canal, puis rejouez l'événement dans Gateway events. |
Le serveur répond method_disabled | Le commutateur est désactivé | Activez-le dans Fees & limits et enregistrez. |
| Le commutateur USDT est grisé | Adresse de dépôt non vérifiée | Cliquez sur Test & verify address dans l'onglet USDT. |