> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/admin/pt-br/settings/payment-gateway.md).

# Gateway de pagamento

Ative pagamentos On-line via Stripe (webhooks e Chaves de API) ou conecte um gateway personalizado usando uma URL de pagamento

Com a Navixy, você pode oferecer aos seus clientes recursos de pagamento on-line usando a Stripe ou outros sistemas populares.

## Aceitando pagamentos com a Stripe

Você pode integrar facilmente a Stripe para receber automaticamente pagamentos on-line de seus clientes.

{% hint style="info" %}
A Stripe é um processador de pagamentos global que oferece suporte a mais de 100 moedas e está disponível em mais de 30 países. Ao integrar a Stripe com a Navixy, você pode aceitar pagamentos on-line usando uma variedade de métodos, incluindo cartões bancários (Visa, Mastercard, American Express), Google Pay, Apple Pay, Alipay e muitos outros.
{% endhint %}

Para ativar a integração com a Stripe, entre em contato com o gerente da sua conta para obter assistência. Depois de ativada, você precisa configurar as seguintes definições técnicas em sua conta da Stripe:

1. Se você ainda não tem uma conta da Stripe, crie uma em <http://stripe.com>.
2. Configure os métodos que você quer aceitar (por exemplo, cartões bancários, carteiras digitais) no seu painel da Stripe.
3. Gere suas Chaves de API e adicione-as à sua conta Navixy para habilitar a comunicação entre as plataformas.

As instruções abaixo orientam você pela configuração específica necessária para integrar a Navixy e a Stripe.

### Como configurar o webhook da Stripe

1. Entre no [painel da Stripe](https://dashboard.stripe.com/).
2. Acesse [Desenvolvedores → Webhooks](https://dashboard.stripe.com/account/webhooks).
3. Clique em **Adicionar endpoint**. Preencha os campos na caixa de diálogo. A **URL do endpoint** depende de onde seu serviço está implantado (servidor da UE ou dos EUA).\
   Plataforma da UE: `https://saas.navixy.com/api-v2/external/payments/<PlatformID>/stripe`\
   Plataforma dos EUA: `https://saas.us.navixy.com/api-v2/external/payments/<PlatformID>/stripe`\
   Substitua `<PlatformID>` pelo ID específico da sua plataforma. Normalmente, esse é o número do seu painel ou o ID que você usa para entrar no painel administrativo.

#### **Filtragem de eventos**

Na **Selecione os eventos para ouvir** (ou **Selecione os tipos para enviar**) seção, selecione apenas os 4 itens a seguir:

1. `charge.refunded`
2. `payment_intent.amount_capturable_updated`
3. `payment_intent.succeeded`
4. `payment_intent.payment_failed`

#### **Chaves de API da Stripe**

Você deve fornecer suas Chaves de API da Stripe à equipe de suporte da Navixy para concluir a integração.

**Chaves de API padrão**

Acesse **Desenvolvedores → Chaves de API**. Recupere os dois parâmetros a seguir:

* `Chave pública`
* `Chave secreta`

**Segredo de assinatura do webhook**

Acesse **Desenvolvedores → Webhooks**. Clique no endpoint de webhook que você acabou de criar. Na seção Signing secret, clique em **Exibir** para obter a chave:

* `Segredo de assinatura`

Depois de concluir estas etapas, você estará pronto para aceitar pagamentos on-line.

## Aceitando pagamentos com outros métodos

Você pode usar praticamente qualquer método de pagamento criando um script personalizado para receber pagamentos on-line. Seu script deve estar acessível por uma URL e processar pagamentos chamando a [API de cobrança da Navixy](https://www.navixy.com/docs/navixy-api/user-api/backend-api/resources/billing).

### Interface do usuário para métodos de pagamento personalizados

Para configurar um gateway de pagamento personalizado:

1. Vá para [Preferências do serviço](/docs/admin/pt-br/settings/service-preferences.md) nas configurações do painel administrativo da Navixy.
2. Insira a URL do sistema de pagamento.

Seu sistema de pagamento precisa processar o parâmetro `/?id={id}`.

Depois de especificar a **URL do sistema de pagamento** na **Domínio & URLs** seção de **Preferências do serviço**, uma **Adicionar dinheiro** opção é habilitada na [Perfil](/docs/user/pt-br/guide/account/profile.md) seção da plataforma web:

<figure><img src="https://1027635053-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKdgeXg71LpaDrwexQYwp%2Fuploads%2Fgit-blob-97017ac769a596600bc601a92848352c96386e77%2Fimage.png?alt=media" alt="Add money link" width="375"><figcaption><p>opção Adicionar dinheiro</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/admin/pt-br/settings/payment-gateway.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.