Payments

O template oferece deposito e saque com suporte a multiplos metodos de pagamento por pais.

Metodos suportados

Metodo	Paises	Descricao
PIX	Brasil	QR code ou copia-e-cola
SPEI	Mexico	Transferencia bancaria (CLABE)
OXXO	Mexico	Pagamento em loja (barcode)
Credit Card	Chile, Mexico, Peru, Finlandia	Gateway de pagamento (iframe)
Bank Transfer	Chile	Transferencia bancaria (iframe)
Khipu	Chile	Pagamento via Khipu (iframe)
Wallet/MACH	Chile	QR code + deep-link para app
AstroPay	Multi	Redirect para AstroPay
Worldline	Multi	Redirect para Worldline
WebPay	Chile	Redirect externo (nova aba)
Crypto	Multi	Carteira de criptomoedas

Os metodos disponiveis sao determinados automaticamente pelo pais e moeda da marca.

Atalhos de valor

Edite app/config/payments/deposit.ts para personalizar os valores de atalho por moeda:

export const depositConfig = {
  shortcuts: {
    BRL: [
      { value: 20 },
      { value: 50, hot: true },  // destaque visual
      { value: 100 },
      { value: 250, hot: true },
      { value: 500 },
      { value: 1000, hot: true },
    ],
    CLP: [
      { value: 5000 },
      { value: 20000, hot: true },
      { value: 50000, hot: true },
      { value: 200000 },
      { value: 400000, hot: true },
      { value: 800000 },
    ],
    // MXN, ARS, COP, UYU, INR, PEN, EUR...
  },
  defaultShortcuts: [
    { value: 20 },
    { value: 50, hot: true },
    { value: 100 },
    { value: 250, hot: true },
    { value: 500 },
    { value: 1000, hot: true },
  ],
};

• value — valor em unidades da moeda (nao em centavos)
• hot: true — adiciona destaque visual ao botao
• Moedas sem configuracao usam defaultShortcuts
• Moedas com atalhos pre-configurados: BRL, MXN, ARS, CLP, COP, UYU, INR, PEN, EUR

Limites

Os limites de deposito e saque sao definidos pela API (brand settings). Fallbacks no template:

Limite	Valor padrao
Deposito minimo	100
Deposito maximo	4.900.000
Saque minimo	100
Saque maximo	50.000

Cupom promocional

O modal de deposito inclui campo de cupom. Cupons sao validados via API e aplicam bonus ao deposito.

Chave PIX (Brasil)

Para marcas brasileiras, o template gerencia a chave PIX do usuario (tipos: CPF, CNPJ, email, telefone, aleatoria). A chave e exibida/atualizada no fluxo de saque.

Conta bancaria (Mexico)

Para marcas mexicanas, o template gerencia a conta bancaria SPEI (CLABE + banco) para saques.

Conta bancaria (Chile)

Para marcas chilenas, o template gerencia a conta bancaria generica (tipo de conta, codigo do banco, numero) para saques via bank-transfer.

Icones de pagamento

Os icones dos metodos de pagamento sao fornecidos automaticamente pelo pacote @cactus-agents/payments. Nao e necessario gerenciar icones manualmente — eles sao copiados para public/icons/ automaticamente pelo build.

Para adicionar icones customizados, coloque SVGs em public/icons/payments/ (eles terao prioridade sobre os do pacote).