# Como conectar a Moyasar à minha loja?

A **Moyasar** permite que clientes na Arábia Saudita paguem online por mada, Visa, Mastercard e Apple Pay na página segura da Moyasar. Os pagamentos são cobrados em riais sauditas (SAR); se a sua loja vende em outra moeda, o total do pedido é convertido para SAR no checkout. O pedido é marcado como pago assim que a Moyasar confirma o pagamento.

## Passos

1. Na Moyasar: cadastre-se em dashboard.moyasar.com. Abra **Settings > API Keys** e copie a chave secreta: `sk_test_…` para o modo de teste, `sk_live_…` quando a Moyasar ativar sua conta.
2. Na Dropify, vá em **Aplicativos → Explorar**, abra **Moyasar** e clique em **Instalar e conectar**.
3. Na página do aplicativo, clique em **Conectar Moyasar** (ou em **Adicionar conta**), dê um nome à conta, cole a **Chave secreta** e clique em **Adicionar conta**. Testamos a chave com a Moyasar antes de salvar.
4. Opcional: copie o endereço mostrado em **URL do webhook** (**Copiar URL do webhook**). Na Moyasar, abra **Settings > Webhooks**, adicione essa URL com um token secreto, depois edite sua conta na Dropify e cole o mesmo token em **Segredo do webhook**. Isso mantém reembolsos e pagamentos com falha sincronizados.
5. Nas **Configurações** do aplicativo, escolha o **Modo de Pagamento**: **Modo Sandbox** com chaves de teste, **Modo Produção** com chaves de produção.
6. Vá em **Configurações da loja → Formas de pagamento** e ative **Moyasar**. A Moyasar é um provedor local de cartões: se outro provedor local de cartões estiver ativado, a Dropify pede para **Substituir** o outro. Opcionalmente, defina um **Desconto para pedidos pré-pagos**.
7. Faça um pedido de teste na sua loja e pague com um cartão de teste da Moyasar.

## Problemas comuns

- "A Moyasar recusou estas chaves no modo de produção…" → a chave não corresponde ao modo. Use `sk_live_` no Modo Produção e `sk_test_` no Modo Sandbox, ou troque o modo.
- "Esta é uma chave de teste da Moyasar, mas o aplicativo está no modo de produção" → cole sua chave de produção, ou mude o aplicativo para o Modo Sandbox.
- Os clientes veem "Esta forma de pagamento está temporariamente indisponível" → sua chave salva não funciona mais (revogada ou gerada de novo). Edite a conta, cole a nova chave e clique em **Testar chaves**.
- A Moyasar não aparece no checkout → confira se o aplicativo está instalado, se o status da conta é **Ativo** e se a Moyasar está ativada em **Formas de pagamento**.

## Relacionados

- available payment gateways by country
- [Como conectar a Paymob à minha loja?](https://help.dropify.shop/pt/payments_gateways/paymob/)
