# Configuração do Multicaixa Express e WhatsApp

## Multicaixa Express (ProxyPay / EMIS GPO)

1. O restaurante precisa de aderir ao serviço de pagamentos GPO/Multicaixa Express através da ProxyPay/EMIS e obter um token Bearer e o `POS_ID` atribuído ao estabelecimento. A documentação oficial descreve a criação de cobranças, deep links e callbacks: https://developer.proxypay.co.ao/opg/v1/.
2. No servidor da aplicação, configure o `.env`:

   ```env
   APP_URL=https://dominio-publico-do-restaurante
   PROXYPAY_TOKEN=token_bearer_fornecido
   PROXYPAY_POS_ID=pos_id_fornecido
   PROXYPAY_BASE_URL=https://api.proxypay.co.ao
   ```

   Para testes com a sandbox, use `https://api.sandbox.proxypay.co.ao` e as credenciais/POS de sandbox.
3. O domínio em `APP_URL` tem de ser público e usar HTTPS para a ProxyPay conseguir chamar o callback `/api/pagamentos/multicaixa/callback`.
4. Depois de alterar o `.env`, execute `php artisan config:clear` e, em produção, `php artisan config:cache`. O utilizador escolhe o valor total ou parcial da factura; cada cobrança reserva esse montante. O saldo da factura fica pago quando as cobranças aceites acumuladas atingirem o total.
5. O site envia o cliente para o deep link/redirect devolvido pelo serviço. No telefone, o cliente precisa de abrir o link num browser móvel e ter o Multicaixa Express instalado/configurado para aceitar o pedido. O pagamento só fica confirmado depois da confirmação assíncrona da ProxyPay.

As credenciais são do estabelecimento e não devem ser colocadas no código-fonte nem partilhadas com clientes.

## WhatsApp para reservas

Na administração, abra **Empresa > Editar** e preencha **WhatsApp para reservas** com o número associado à conta WhatsApp do restaurante, incluindo o indicativo do país, por exemplo `244923000000` (sem `+`, espaços ou traços). O formulário de reserva cria uma mensagem pronta e abre `wa.me` para o cliente enviar ao restaurante. Não é necessária uma chave da API WhatsApp para este fluxo de clique para conversar.

Se o campo estiver vazio, o sistema usa o telefone geral da empresa.

## Aplicar a migração

No diretório da aplicação, execute `php artisan migrate` para criar o registo de cobranças parciais e o campo WhatsApp. Depois configure as variáveis e limpe/recrie a cache de configuração.