> 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

Com a Navixy, você pode oferecer aos seus clientes a capacidade de pagamento online usando Stripe ou outros sistemas populares.

## Aceitando pagamentos com Stripe

Você pode integrar o Stripe facilmente para receber pagamentos online de seus clientes automaticamente.

{% hint style="info" %}
Stripe é um processador de pagamentos global que suporta 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 online usando diversos 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 seu gerente de conta para obter assistência. Uma vez ativada, será necessário configurar as seguintes definições técnicas na sua conta Stripe:

1. Se você ainda não possui uma conta Stripe, crie uma em <http://stripe.com>.
2. Configure os métodos que deseja aceitar (por exemplo, cartões bancários, carteiras digitais) dentro do painel do 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 sobre a 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. Navegue até [Developers → Webhooks](https://dashboard.stripe.com/account/webhooks).
3. Clique **Adicionar endpoint**. Preencha os campos na caixa de diálogo. O **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 este é o número do seu painel ou o ID que você usa para entrar no painel Admin.

#### **Filtragem de eventos**

Na seção **Selecionar eventos para escutar** (ou **Selecionar tipos para enviar**) seção, selecione apenas os seguintes 4 itens:

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**

Navegue até **Developers → API keys**. Recupere os dois parâmetros a seguir:

* `Publishable key`
* `Secret key`

**Segredo de assinatura do webhook**

Navegue até **Developers → Webhooks**. Clique no endpoint de webhook que acabou de criar. Na seção Signing secret, clique em **Revelar** para obter a chave:

* `Signing secret`

Depois de concluir essas etapas, você estará pronto para aceitar pagamentos online.

## Aceitando pagamentos por outros métodos

Você pode usar praticamente qualquer método de pagamento criando um script personalizado para receber pagamentos online. Seu script deve estar acessível via URL e processar pagamentos chamando a [Navixy Billing API](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 de serviço](/docs/admin/pt-br/settings/service-preferences.md) nas configurações do Painel Admin da Navixy.
2. Insira a URL do sistema de pagamento.

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

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

<figure><img src="/files/f215c5d76f729e670c97723edce2656cbe1efbfe" 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:

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

The question should be specific, self-contained, and written in natural language.
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.