Módulo de pagamento AQpay para Medusa
Para equipes que constroem lojas headless em Medusa v2 e precisam integrar cartão, Pix e boleto no servidor e na vitrine.
Homologação em loja pendente. Testes com chave de produção geram cobranças reais.
Meios de pagamento no Medusa
- Cartão de créditoDisponível conforme habilitação
- PixDisponível conforme habilitação
- BoletoDisponível conforme habilitação
- Google PayNão confirmado
- Apple PayNão disponível nesta versão
Parcelamento: Configuração de 1 a 21 parcelas; padrão de 12 na versão 1.1.0.
Venda com cartão em até 21x e receba suas vendas parceladas em 1 dia, conforme o plano contratado e a aprovação da transação. Aceite também Pix, boleto bancário e carteiras digitais nos módulos compatíveis.
Todos os módulos AQpay são gratuitos: você paga apenas as taxas das vendas, conforme sua conta AQpay.
Condições comerciais dependem do plano contratado e da aprovação de cada transação. O prazo de recebimento é uma condição comercial da conta AQpay, não uma função do módulo, e a disponibilidade de cada meio de pagamento varia por plataforma e versão.
Demonstração em vídeo
Como funciona no Medusa
- Provedor de pagamento para o servidor Medusa v2.
- Não oferece recorrência, captura manual nem estorno ou cancelamento automáticos nesta versão.
- Pix e boleto ficam pendentes até a confirmação do pagamento.
Requisitos e instalação
Requisitos
- Conta AQpay ativa.
- Chave de integração gerada no painel AQpay e vinculada à loja Medusa. Nunca envie essa chave por e-mail, chat ou formulários do site.
- Loja publicada em endereço HTTPS.
- Servidor Medusa v2 e vitrine (storefront) sob seu controle.
- Atenção: chaves de produção geram cobranças reais nos testes.
Passo a passo
- No servidor, instale o pacote @aqpay/medusa-payment com seu gerenciador de pacotes.
- Registre o provedor no medusa-config com a chave lida de variável de ambiente.
- Habilite o provedor AQpay na região desejada pelo painel do Medusa.
- Integre a vitrine pela opção A ou B abaixo.
Opção A — Página de pagamento hospedada AQpay
A vitrine cria a sessão de pagamento no servidor Medusa e envia o comprador para a página AQpay. Você integra o botão de pagar e a página de retorno. O retorno do comprador não confirma o pedido: ele só é concluído após a confirmação do pagamento.
Opção B — Pacote React @aqpay/medusa-react
Componentes prontos para a vitrine React. O servidor continua precisando do provedor @aqpay/medusa-payment: o pacote React não elimina essa integração. Pix e boleto ficam pendentes até o pagamento.
Precisa de referência técnica geral? Consulte a documentação AQpay.
