PHPay — Pagamentos Asaas

• Site: https://www.phpbusiness.com.br
• E-mail: suporte@phpbusiness.com.br
• WhatsApp: +55 44 9 9754-7072
• Chat ao vivo no portal (Canal Bitrix24): https://suporte.phpbusiness.com.br

Horário de atendimento: Segunda a sexta, 09:00–17:00 (Horário de Brasília, UTC-3).
Tempo de resposta: até 24 horas úteis.

PHP BUSINESS ADVISORS LTDA
CNPJ: 52.872.881/0001-34
Rua Caracas, 754 — Vila Moranguera, Maringá, PR, Brasil.

# Instalação

Instale o PHPay diretamente pelo Bitrix24 Marketplace em um clique. O app se registra automaticamente nos cards de Negócio, Contato e Empresa, configura os handlers de eventos do Bitrix24 e se cadastra como gateway de pagamento na Loja Online, Formulários CRM e Terminal de Pagamento — sem nenhuma configuração manual.

## Requisitos

Antes de instalar, você precisa de:
- Uma conta Bitrix24 ativa num plano que suporte apps do Marketplace
- Uma conta Asaas ativa (sandbox ou produção) — cadastre-se grátis em www.asaas.com
- Uma chave de API Asaas em Painel Asaas → Minha Conta → Integrações → Chave de API
- Permissões de administrador no seu portal Bitrix24 (obrigatório para a instalação inicial)

O PHPay opera no Brasil — a cobrança de clientes exige CPF (pessoa física) ou CNPJ (pessoa jurídica) válidos.

## Passo a passo

1. Clique em "Instalar" na página do PHPay no Bitrix24 Marketplace.

2. Revise as permissões solicitadas e confirme a instalação. O PHPay se registra automaticamente nos cards de Negócio, Contato e Empresa do CRM como a aba "Faturas PHPay", e se cadastra como gateway de pagamento na Loja Online, Formulários CRM e Terminal de Pagamento.

3. Após a instalação, abra o PHPay pela lista de aplicativos. A tela de configurações carrega automaticamente.

4. Na aba "API Asaas", cole sua chave de API Asaas (encontre em Painel Asaas → Minha Conta → Integrações → Chave de API). Clique em "Testar Conexão" para validar. Clique em "Salvar Configurações" — o PHPay cria automaticamente o webhook, configura os eventos e armazena o token criptografado.

5. Revise a aba "Depara". O PHPay pré-seleciona os campos mais comuns do Bitrix24 para Pessoa Física (PF) e Pessoa Jurídica (PJ). Ajuste apenas se seu CRM armazenar esses dados em outra entidade (por exemplo, no Negócio em vez do Contato).

6. (Opcional) Acesse a aba "Permissões" para definir quem pode criar, editar, enviar ou cancelar cobranças. Por padrão, administradores do Bitrix24 têm acesso total.

7. Abra qualquer card de Negócio, Contato ou Empresa. Você verá a aba "Faturas PHPay". Clique em "+ Adicionar fatura" para iniciar o wizard de cobrança em 4 etapas.

8. Para usar o PHPay na Loja Online ou nos Formulários CRM, nenhuma configuração adicional é necessária — o gateway de pagamento já está registrado. Basta selecionar "Asaas — Pix, Boleto e Cartão" durante a configuração do checkout.

## O que acontece após a instalação

O PHPay automaticamente:
- Cria a aba "Faturas PHPay" em todos os cards de Negócio, Contato e Empresa
- Registra o Asaas como opção de pagamento no checkout da Loja Online
- Registra-se como provedor de pagamento nos Formulários CRM e no Terminal de Pagamento
- Se inscreve no evento de desinstalação do Bitrix24 para limpeza adequada
- Inicia seu período de teste gratuito de 14 dias

## Planos

14 dias de teste gratuito com funcionalidade completa. Depois, o plano é de R$ 95,00/mês, sem fidelidade, cancele quando quiser. Uma conta Asaas ativa é obrigatória — o Asaas cobra suas próprias taxas por transação, independentes do PHPay.

## Desinstalação

A desinstalação do PHPay remove todos os placements e handlers. Se você marcar "excluir dados" durante a desinstalação, seu histórico de faturas no PHPay também é removido; caso contrário, seus dados são preservados e serão restaurados se você reinstalar no mesmo portal.

## Suporte

Dúvidas? Entre em contato: suporte@phpbusiness.com.br