# 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](https://www.navixy.com/docs/admin/pt-br/settings/service-preferences) 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](https://app.gitbook.com/s/446mKak1zDrGv70ahuYZ/guide/account/profile) seção da plataforma web:

<figure><img src="https://4025454174-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKdgeXg71LpaDrwexQYwp%2Fuploads%2FliBVaeL4ehwe2pRaCLOG%2Fimage.png?alt=media&#x26;token=66e556b7-2aad-4b1a-b88f-da424577fa6c" alt="Add money link" width="375"><figcaption><p>Opção Adicionar dinheiro</p></figcaption></figure>
