Pagamentos
A camada de pagamento que vem com o core, e os módulos de gateway que se conectam a ela.
Payments é um módulo do core. É a camada pela qual todo outro módulo cobra, e é por isso que o LMS não precisa do Members Plus para vender um curso.
O registro de gateways#
O módulo de pagamentos guarda o registro; cada gateway é um módulo separado que registra um driver quando é inicializado. Três vêm como módulos oficiais:
| Módulo | O que cobre |
|---|---|
| Payments: Stripe | Stripe Checkout hospedado: cobranças únicas, planos recorrentes, testes grátis, taxas de configuração e prazos vitalícios |
| Payments: PayPal | Cobranças únicas através de Orders, planos recorrentes através de Billing Subscriptions |
| Payments: Mercado Pago | Checkout hospedado através de preferences, recorrência através de preapproval, bom para PIX e a América Latina |
Um método offline vem embutido no próprio módulo de pagamentos: o membro avisa que pagou por transferência bancária e um administrador aprova manualmente.
Instalando um gateway#
Um gateway se instala como qualquer outro módulo, em Módulos. Ele aparece como filho de Payments na lista. Desativá-lo remove a seção dele das configurações, o método dele do checkout e o endpoint de webhook dele, e não toca em mais nada.
Configurações#
Payments > Settings cobre a moeda de venda, a porcentagem de imposto, a numeração de faturas e as credenciais de cada gateway instalado. Cada gateway tem a própria seção, que só aparece enquanto aquele módulo estiver ativado.
Webhooks#
Todo gateway verifica a assinatura do callback do provedor antes de agir sobre ele, e processa cada evento uma única vez. O endpoint aparece nas configurações do gateway, pronto para colar no painel do provedor.
Warning Um checkout que se completa do lado do provedor mas nunca chega ao seu servidor é quase sempre um webhook que nunca foi configurado. É a primeira coisa a conferir quando um pagamento é concluído e o membro não recebe o acesso.
Teste antes de lançar#
Todo gateway tem um modo de teste. Rode uma compra completa, um reembolso e um cancelamento em modo de teste antes de trocar as chaves para produção.