# Como conectar a PayMongo à minha loja?

A PayMongo permite que clientes nas Filipinas paguem por cartão, GCash, Maya, GrabPay ou QR Ph no checkout seguro da PayMongo, usando a sua própria conta PayMongo. Ela cobra somente em pesos filipinos (PHP), então só aparece no checkout quando seus preços estão em PHP.

## Passos

1. No seu painel da PayMongo (dashboard.paymongo.com), abra **Developers > API Keys** e copie a **chave secreta**. As chaves de teste começam com `sk_test_`, as de produção com `sk_live_`.
2. Na Dropify, vá em **Aplicativos**, encontre **PayMongo** e clique em **Instalar e conectar**.
3. Na página do aplicativo, clique em **Conectar PayMongo**, digite um **Nome da conta**, preencha **Chave secreta** e **Segredo do webhook**, depois clique em **Adicionar conta**. A Dropify verifica as chaves com a PayMongo antes de salvar.
4. Recomendado: em **URL do webhook**, clique em **Copiar URL do webhook** e adicione-a na PayMongo (**Developers > Webhooks**, evento checkout_session.payment.paid), e cole o segredo dele em **Segredo do webhook**. Assim, os pagamentos são confirmados mesmo que o cliente feche a página.
5. Na seção **Configurações**, escolha **Modo Sandbox** para testar ou **Modo Produção** para pagamentos reais, com as chaves correspondentes.
6. Vá em **Pagamentos > Formas de pagamento** e ative a PayMongo. Você também pode definir um **Desconto para pedidos pré-pagos** para ela.
7. Faça um pedido de teste em PHP e pague na página de teste da PayMongo.

## Problemas comuns

- "A PayMongo recusou estas chaves no modo de teste…" → chaves do outro modo, ou copiadas com espaços. Copie-as de novo ou troque o modo em **Configurações**.
- A PayMongo não aparece no checkout → seus preços (ou a moeda do visitante) não estão em PHP, ou a PayMongo está desativada em **Pagamentos > Formas de pagamento**.
- O cliente vê "Você cancelou o pagamento. Você pode tentar de novo ou escolher outra forma de pagamento." → ele saiu da página da PayMongo sem pagar.
- Um pedido pago mais tarde continua sem pagamento → o webhook está faltando ou o segredo dele não corresponde. Cole a URL do webhook na PayMongo e copie o segredo de novo.

## Relacionados

- [Como conecto o Xendit à minha loja?](https://help.dropify.shop/pt/payments_gateways/xendit/)
- available payment gateways by country
