---
title: Canais de pagamento
description: Como os clientes recarregam a carteira no NexCMP — os canais disponíveis, como ativar cada um, taxas, limites e como monitorá-los.
url: https://nexcmp.com/pt/docs/billing/payment-channels/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Canais de pagamento {#payment-channels}

> **Onde encontrar no admin:** Finance › Payment channels (`/payments`). Alternadores e taxas: Finance › Payment channels › Fees & limits (`/payments/fees`).

O NexCMP usa uma **carteira pré-paga em USD**. Os clientes adicionam saldo à carteira por meio de um canal de pagamento; cada serviço é pago a partir da carteira. Um canal só é exibido para os clientes quando está **ativado** e **configurado**.

## O que faz {#what-it-does}

Os canais de pagamento conectam suas contas de pagamento (Stripe, PayPal, Binance, um banco vietnamita) à carteira do cliente. Um pagamento confirmado se torna exatamente um crédito na carteira — cada crédito é identificado pelo ID de pagamento do gateway, portanto, um webhook repetido nunca poderá adicionar dinheiro duas vezes. Use esta página para ver quais canais estão prontos, como eles se saíram nos últimos 30 dias e quais precisam de atenção.

## Requisitos {#requirements}

| Item | Requisito |
|---|---|
| Endereço HTTPS público | Os gateways enviam webhooks para `https://<domain>/v1/billing/...`, portanto, seu painel deve estar acessível a partir da Internet por TLS válido (consulte [DNS and Cloudflare](https://nexcmp.com/pt/docs/getting-started/dns-and-cloudflare/)). |
| Contas | Sua própria conta em cada provedor que deseja usar. As credenciais são inseridas no painel administrativo e nunca mais são exibidas (apenas os últimos 4 caracteres). |
| Papel de administrador | Uma conta de administrador. |
| Dependências | Nenhum. O canal de banco do Vietnã também precisa de uma [exchange rate](https://nexcmp.com/pt/docs/catalog/currency-and-exchange-rates/). |

## Os canais {#the-channels}

| Canal | O que o cliente vê | Configurado em | Artigo |
|---|---|---|---|
| Cartão (Stripe) | Formulário de cartão, cartão salvo | Payment channels › Stripe | [Stripe](https://nexcmp.com/pt/docs/billing/stripe/) |
| Apple Pay, Google Pay, Link | Botões de carteira (Stripe Express Checkout) | Stripe, mais registro de domínio | [Stripe](https://nexcmp.com/pt/docs/billing/stripe/#apple-pay-google-pay-and-link) |
| Alipay | Redirecionamento para o Alipay (cobrado em JPY pela Stripe) | Stripe, mais Fees & limits | [Stripe](https://nexcmp.com/pt/docs/billing/stripe/#alipay) |
| PayPal | Botões do PayPal, conta do PayPal salva | Payment channels › PayPal | [PayPal](https://nexcmp.com/pt/docs/billing/paypal/) |
| USDT | Endereço de depósito e valor exato | Payment channels › USDT | [USDT](https://nexcmp.com/pt/docs/billing/usdt/) |
| Transferência bancária VN | QR code e detalhes da transferência (apenas interface em vietnamita) | Payment channels › VN bank transfer | [Bank transfer (Vietnam)](https://nexcmp.com/pt/docs/billing/bank-transfer-vn/) |

## Preparar a infraestrutura {#prepare-the-infrastructure}

Não é necessário. Tudo é configurado no admin; não há nada para instalar no servidor.

## Conectar no NexCMP {#connect-in-nexcmp}

1. Abra **Finance › Payment channels** (`/payments`). A tabela de visão geral lista cada canal com seu estado.
2. Abra a aba própria do canal (**Stripe**, **PayPal**, **USDT**, **VN bank transfer**) e siga o artigo correspondente. Cada aba termina com um botão **Save** e, quando disponível, um botão **Test**.
3. Abra **Fees & limits** (`/payments/fees`), localize o cartão **Payment gateways & fees (wallet top-up)**, ative o canal com a chave correspondente e clique em **Save channels & fees**.

![Visão geral dos canais de pagamento listando os gateways com seus status de ativado, configurado e estatísticas de 30 dias](https://nexcmp.com/pt/docs/images/billing/payment-channels-01-overview.webp)

![Página de taxas e limites com as chaves dos canais e os campos de taxa](https://nexcmp.com/pt/docs/images/billing/payment-channels-02-fees.webp)

### Chaves e taxas (Fees & limits) {#switches-and-fees-fees-limits}

| Configuração | Padrão | Significado |
|---|---|---|
| Cartão (Stripe) | On | Formulário de cartão na tela de depósito. Oculto até que a Stripe tenha uma chave secreta. |
| Apple Pay, Google Pay, Link | On | Botões de carteira. Eles aparecem apenas quando o domínio é verificado na Stripe. |
| Alipay | Desligado | Requer o Alipay ativado no Dashboard da Stripe. |
| PayPal | Desligado | Exibido apenas quando o PayPal está configurado. |
| USDT (Binance) | Desligado | A chave fica bloqueada até que o endereço de depósito seja verificado junto à Binance. |
| Taxa da Stripe % / fixa (centavos) | 3.6 % e 0 | Usado para mostrar a taxa ao cliente e calcular o valor creditado. Defina com sua tarifa real da Stripe. |
| Taxa do PayPal % / fixa | 4.4 % e 30 centavos | O mesmo, para o PayPal. |
| Taxa de USDT % | 1 % | O mesmo, para USDT. |
| O cliente paga a taxa de recarga | Desligado | **On**: o cliente paga o valor + taxa e a carteira recebe o valor integral. **Off**: a taxa é deduzida e a carteira recebe o valor menos a taxa. |

O cliente sempre vê a taxa e o crédito final na carteira antes de pagar. Desativar um canal oculta o botão e o servidor recusa novos pagamentos com `method_disabled` (HTTP 403).

::: tip Limites de recarga
Os valores mínimo e máximo por recarga estão na mesma página — consulte [Minimum top-up](https://nexcmp.com/pt/docs/billing/minimum-top-up/).
:::

## Verificar {#verify}

1. Na tabela de visão geral, o canal mostra **Enabled** e **Configured**; a coluna **Last test** é preenchida após clicar em **Test** na aba do canal.
2. Entre no portal como um cliente de teste e abra **Billing › Deposit**. O botão do canal está presente.
3. Faça um pequeno pagamento (consulte o artigo do canal para cartões de teste ou contas de sandbox). O saldo aumenta, uma notificação de **Top-up received** aparece e o pagamento é listado em **Finance › Billing › Top-ups** (`/billing/deposits`).

## Limites e notas {#limits-notes}

- **Colunas da visão geral:** *30 days* (número de pagamentos, sucessos, falhas e volume), *Stuck 24h* (pagamentos ainda pendentes após um dia) e *Unmatched* (USDT ou transferências bancárias que chegaram mas não correspondem a nenhum pedido). A linha de KPI adiciona o volume de 30 dias, o número de canais com falha (ativados mas não configurados, ou pagamentos travados) e o total não correspondido.
- **Eventos de webhook** estão listados em **Payment channels › Gateway events** (`/payments/events`). O Stripe tem sua própria aba; PayPal e USDT compartilham uma. Um evento com falha pode ser reproduzido — o razão da carteira é idempotente, portanto, reproduzir nunca credita duas vezes.
- **Resellers** podem ter seus próprios canais do Stripe, PayPal, USDT e bancários. As linhas deles também aparecem aqui, e o seletor de site no cabeçalho os filtra. Consulte [Resellers](https://nexcmp.com/pt/docs/customers/resellers/).
- **Reembolsos:** Pagamentos via Stripe e PayPal podem ser reembolsados a partir da lista de pagamentos; pagamentos em USDT não podem ser reembolsados para a origem (o servidor responde `usdt_no_refund`).
- **Modo de manutenção** ainda aceita webhooks de gateway, portanto, um pagamento feito pouco antes da manutenção não é perdido.

## Resolução de problemas {#troubleshooting}

| Sintoma | Causa | Correção |
|---|---|---|
| Canal ausente na tela de depósito do cliente | Desativado, não configurado ou (banco do VN) a interface não está em vietnamita | Verifique **Fees & limits** e a aba do canal; consulte [Bank transfer (Vietnam)](https://nexcmp.com/pt/docs/billing/bank-transfer-vn/). |
| O KPI **Faulty channels** está acima de 0 | Um canal está ativado sem credenciais, ou os pagamentos estão pendentes há mais de 24 horas | Abra a linha e clique em **Configure**; para pagamentos travados, abra **Gateway events** e reproduza. |
| O cliente pagou mas o saldo não mudou | O webhook não chegou | Verifique a URL do webhook na aba do canal e, em seguida, reproduza o evento em **Gateway events**. |
| O servidor responde `method_disabled` | A chave está desativada | Ative-a em **Fees & limits** e salve. |
| A chave do USDT está esmaecida | Endereço de depósito não verificado | Clique em **Test & verify address** na aba do USDT. |