Canales de pago
Dónde está en el panel de administración: Finance › Payment channels (
/payments). Interruptores y comisiones: Finance › Payment channels › Fees & limits (/payments/fees).
NexCMP utiliza una billetera prepagada en USD. Los clientes añaden fondos a la billetera mediante un canal de pago; luego, cada servicio se paga desde la billetera. Un canal solo se muestra a los clientes cuando está tanto habilitado como configurado.
Qué hace
Los canales de pago conectan sus cuentas de pago (Stripe, PayPal, Binance, un banco vietnamita) con la billetera del cliente. Un pago confirmado se convierte en exactamente un crédito en la billetera; cada crédito se indexa mediante el ID de pago de la pasarela, por lo que un webhook repetido nunca podrá añadir fondos dos veces. Utilice esta página para ver qué canales están listos, cómo funcionaron durante los últimos 30 días y cuáles requieren atención.
Requisitos
| Elemento | Requisito |
|---|---|
| Dirección HTTPS pública | Las pasarelas envían webhooks a https://<domain>/v1/billing/..., por lo que su panel debe ser accesible desde Internet mediante TLS válido (consulte DNS y Cloudflare). |
| Cuentas | Su propia cuenta con cada proveedor que desee utilizar. Las credenciales se introducen en el panel de administración y no se vuelven a mostrar (solo los últimos 4 caracteres). |
| Rol de administrador | Una cuenta de administrador. |
| Dependencias | Ninguno. El canal bancario de VN necesita además un tipo de cambio. |
Los canales
| Canal | Lo que ve el cliente | Se configura en | Artículo |
|---|---|---|---|
| Tarjeta (Stripe) | Formulario de tarjeta, tarjeta guardada | Payment channels › Stripe | Stripe |
| Apple Pay, Google Pay, Link | Botones de billetera (Stripe Express Checkout) | Stripe, más registro de dominio | Stripe |
| Alipay | Redirección a Alipay (cobrado en JPY por Stripe) | Stripe, más Fees & limits | Stripe |
| PayPal | Botones de PayPal, cuenta de PayPal guardada | Payment channels › PayPal | PayPal |
| USDT | Dirección de depósito e importe exacto | Payment channels › USDT | USDT |
| Transferencia bancaria de VN | Código QR y detalles de transferencia (solo en la interfaz en vietnamita) | Payment channels › VN bank transfer | Transferencia bancaria (Vietnam) |
Preparar la infraestructura
No es necesario. Todo se configura en el panel de administración; no hay nada que instalar en el servidor.
Conectar en NexCMP
- Abra Finance › Payment channels (
/payments). La tabla general enumera cada canal con su estado. - Abra la pestaña propia del canal (Stripe, PayPal, USDT, VN bank transfer) y siga su artículo. Cada pestaña finaliza con un botón Save y, donde esté disponible, un botón Test.
- Abra Fees & limits (
/payments/fees), busque la tarjeta Payment gateways & fees (wallet top-up), active el canal con su interruptor y haga clic en Save channels & fees.
Interruptores y comisiones (Fees & limits)
| Ajuste | Predeterminado | Significado |
|---|---|---|
| Tarjeta (Stripe) | On | Formulario de tarjeta en la pantalla de depósito. Oculto hasta que Stripe tenga una clave secreta. |
| Apple Pay, Google Pay, Link | On | Botones de billetera. Solo aparecen cuando el dominio está verificado en Stripe. |
| Alipay | Desactivado | Requiere que Alipay esté activado en el Stripe Dashboard. |
| PayPal | Desactivado | Se muestra solo cuando PayPal está configurado. |
| USDT (Binance) | Desactivado | El interruptor está bloqueado hasta que la dirección de depósito haya sido verificada con Binance. |
| Comisión de Stripe % / fija (centavos) | 3.6 % y 0 | Se utiliza para mostrar la comisión al cliente y calcular el importe acreditado. Establézcalo según su tarifa real de Stripe. |
| Comisión de PayPal % / fija | 4.4 % y 30 centavos | Lo mismo, para PayPal. |
| Comisión de USDT % | 1 % | Lo mismo, para USDT. |
| El cliente paga la comisión de recarga | Desactivado | On: el cliente paga el importe + la comisión y el monedero recibe el importe íntegro. Off: se descuenta la comisión y el monedero recibe el importe menos la comisión. |
El cliente siempre ve la comisión y el crédito final del monedero antes de pagar. Al desactivar un canal, se oculta el botón y el servidor rechaza nuevos pagos con method_disabled (HTTP 403).
Límites de recarga
El importe mínimo y máximo por recarga se encuentran en la misma página; consulte Minimum top-up.
Verificación
- En la tabla general, el canal muestra Enabled y Configured; la columna Last test se completa tras hacer clic en Test en la pestaña del canal.
- Inicie sesión en el portal como cliente de prueba y abra Billing › Deposit. El botón del canal estará visible.
- Realice un pago pequeño (consulte el artículo del canal para obtener tarjetas de prueba o cuentas sandbox). El saldo aumentará, aparecerá una notificación de Top-up received y el pago se listará en Finance › Billing › Top-ups (
/billing/deposits).
Límites y notas
- Columnas del resumen: 30 days (número de pagos, operaciones correctas, fallos y volumen), Stuck 24h (pagos aún pendientes tras un día) y Unmatched (transferencias bancarias o en USDT recibidas que no coinciden con ningún pedido). La fila de KPI añade el volumen a 30 días, el número de canales con errores (habilitados pero no configurados, o con pagos bloqueados) y el total sin asignar.
- Los eventos de webhook se listan en Payment channels › Gateway events (
/payments/events). Stripe dispone de su propia pestaña; PayPal y USDT comparten una. Si un evento falla, puede reproducirse: el libro mayor del monedero es idempotente, por lo que reintentarlo nunca acredita dos veces. - Los Resellers pueden tener sus propios canales de Stripe, PayPal, USDT y cuentas bancarias. Sus filas también aparecen aquí y el selector de sitio de la cabecera permite filtrarlas. Consulte Resellers.
- Reembolsos: los pagos de Stripe y PayPal pueden reembolsarse desde la lista de pagos; los pagos con USDT no pueden reembolsarse al origen (el servidor responde
usdt_no_refund). - El modo de mantenimiento sigue aceptando los webhooks de las pasarelas, por lo que un pago efectuado justo antes del mantenimiento no se pierde.
Resolución de problemas
| Síntoma | Causa | Solución |
|---|---|---|
| Falta el canal en la pantalla de depósito del cliente | Desactivado, no configurado o (banco de VN) la interfaz no está en vietnamita | Compruebe Fees & limits y la pestaña del canal; consulte Bank transfer (Vietnam). |
| El KPI Faulty channels es superior a 0 | Un canal está habilitado sin credenciales o hay pagos pendientes durante más de 24 horas | Abra la fila y haga clic en Configure; para pagos bloqueados, abra Gateway events y vuelva a reproducirlos. |
| El cliente pagó pero el saldo no cambió | El webhook no llegó | Compruebe la URL del webhook en la pestaña del canal y luego reproduzca el evento en Gateway events. |
El servidor responde method_disabled | El interruptor está desactivado | Actívelo en Fees & limits y guarde los cambios. |
| El interruptor de USDT aparece atenuado | Dirección de depósito no verificada | Haga clic en Test & verify address en la pestaña de USDT. |