> 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 o Stripe ou outros sistemas populares.

## Aceitando pagamentos com Stripe

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

{% hint style="info" %}
O 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 o 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 o Stripe, entre em contato com o gerente da sua conta para obter ajuda. Depois de ativada, você precisa configurar as seguintes definições técnicas na sua conta do Stripe:

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

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

### Como configurar o webhook do Stripe

1. Faça login no [painel do Stripe](https://dashboard.stripe.com/).
2. Vá para [Developers → Webhooks](https://dashboard.stripe.com/account/webhooks).
3. Clique em **Add endpoint**. Preencha os campos na caixa de diálogo. A **Endpoint URL** depende de onde o 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 de administração.

#### **Filtrando eventos**

Na seção **Select events to listen to** (ou **Select types to send**), 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 do Stripe**

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

**Chaves de API padrão**

Vá para **Developers → Chaves de API**. Recupere os dois parâmetros a seguir:

* `Publishable key`
* `Secret key`

**Webhook signing secret**

Vá para **Developers → Webhooks**. Clique no endpoint do webhook que você acabou de criar. Na seção Signing secret, clique em **Reveal** para obter a chave:

* `Signing secret`

Depois de concluir essas 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 meio de uma URL e processar pagamentos chamando a [API de faturamento da Navixy](https://www.navixy.com/docs/navixy-api/user-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 de serviço](/docs/admin/pt-br/settings/service-preferences.md) nas configurações do Painel de administração 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 e URLs** seção de **Preferências de serviço**, uma **Adicionar saldo** opção é ativada 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 saldo</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.