🔗 Integrações da MedPay

A MedPay oferece integrações robustas com os principais sistemas do ecossistema de saúde e financeiro.

💳 Gateway de Pagamentos

Celcoin

Gateway principal de pagamentos

• PIX: Transações instantâneas
• Cartão de Crédito: Todas as bandeiras
• Boleto: Geração e consulta
• Split de Pagamentos: Divisão automática

Configuração

{
  "apiKey": "sua_api_key",
  "environment": "sandbox|production",
  "webhookUrl": "https://sua-app.com/webhook/celcoin"
}

Webhooks Disponíveis

• payment.approved - Pagamento aprovado
• payment.denied - Pagamento negado
• payment.pending - Pagamento pendente
• payment.refunded - Pagamento estornado

🏥 Sistemas de Gestão Médica

Ninsaúde (PMS)

Sistema de gestão de clínicas

• Sincronização de pacientes
• Agendamentos e consultas
• Histórico médico
• Status de procedimentos

Endpoints Principais

GET /api/ninsaude/patients
POST /api/ninsaude/appointments
PUT /api/ninsaude/procedures/{id}/status

Helena (CRM)

Gestão de relacionamento com clientes

• Leads e oportunidades
• Histórico de interações
• Campanhas de marketing
• Segmentação de clientes

Configuração

{
  "apiToken": "seu_token_helena",
  "baseUrl": "https://api.helena.com.br",
  "syncInterval": "15min"
}

📊 Contabilidade e Fiscal

Nibo

Sistema contábil integrado

• Lançamentos automáticos
• Notas fiscais eletrônicas
• Relatórios fiscais
• Conciliação bancária

Funcionalidades

• Geração automática de NFs
• Lançamentos contábeis
• Relatórios de vendas
• Conciliação de recebimentos

📝 Assinatura Eletrônica

Clicksign

Contratos e documentos digitais

• Assinatura de contratos
• Validação de documentos
• Histórico de assinaturas
• Compliance legal

Fluxo de Assinatura

1. Geração do contrato
2. Envio para assinatura
3. Notificação de conclusão
4. Armazenamento seguro

📧 Comunicação

Email (SendGrid)

Envio de emails transacionais

• Templates personalizados
• Segmentação de usuários
• Métricas de entrega
• A/B testing

SMS (Twilio)

Notificações por SMS

• Lembretes de pagamento
• Códigos de verificação
• Alertas de status
• Campanhas promocionais

WhatsApp Business

Atendimento via WhatsApp

• Chat automatizado
• Notificações de status
• Suporte ao cliente
• Campanhas de engajamento

🏦 Bancos e Financeiro

Open Banking

Integração com bancos

• Consulta de saldo
• Histórico de transações
• Validação de conta
• PIX automático

Conciliação Bancária

Matching automático

• Importação de extratos
• Reconciliação de transações
• Alertas de divergências
• Relatórios de conciliação

📊 Business Intelligence

Exportação de Dados

Múltiplos formatos

• CSV: Para planilhas
• JSON: Para sistemas
• Parquet: Para big data
• API: Para integrações

Webhooks

Eventos em tempo real

{
  "event": "payment.completed",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "paymentId": "pay_123456",
    "amount": 1500.00,
    "status": "approved"
  }
}

🔧 APIs e SDKs

REST API

API completa para integração

Autenticação

POST /api/auth/token
Content-Type: application/json

{
  "clientId": "seu_client_id",
  "clientSecret": "seu_client_secret"
}

Endpoints Principais

• GET /api/payments - Listar pagamentos
• POST /api/payments - Criar pagamento
• GET /api/patients - Listar pacientes
• POST /api/patients - Criar paciente
• GET /api/clinics - Listar clínicas
• POST /api/clinics - Criar clínica

SDKs Disponíveis

• JavaScript/Node.js
• Python
• PHP
• Java
• C#/.NET

Exemplo de Uso (JavaScript)

import { MedPayClient } from '@medpay/sdk';

const client = new MedPayClient({
  apiKey: 'sua_api_key',
  environment: 'sandbox'
});

// Criar um pagamento
const payment = await client.payments.create({
  amount: 1500.00,
  patientId: 'patient_123',
  clinicId: 'clinic_456',
  installments: 12
});

🔐 Segurança

Autenticação

• OAuth 2.0 com PKCE
• JWT tokens com refresh
• API Keys para integrações
• Rate limiting por endpoint

Criptografia

• TLS 1.3 para todas as comunicações
• AES-256 para dados sensíveis
• RSA-2048 para chaves
• HMAC-SHA256 para assinaturas

Compliance

• PCI-DSS para dados de cartão
• LGPD para dados pessoais
• ISO 27001 para segurança
• SOC 2 para controles

📋 Configuração de Integrações

Ambiente de Desenvolvimento

# Configurar variáveis de ambiente
export MEDPAY_API_KEY="sua_api_key_sandbox"
export MEDPAY_WEBHOOK_SECRET="seu_webhook_secret"
export CELCOIN_API_KEY="sua_celcoin_key"

Ambiente de Produção

# Configurar variáveis de produção
export MEDPAY_API_KEY="sua_api_key_production"
export MEDPAY_WEBHOOK_SECRET="seu_webhook_secret_prod"
export CELCOIN_API_KEY="sua_celcoin_key_prod"

🧪 Testes e Validação

Sandbox

Ambiente de testes

• Dados fictícios para testes
• Simulação de pagamentos
• Webhooks de teste
• Logs detalhados

Validação de Webhooks

const crypto = require('crypto');

function validateWebhook(payload, signature, secret) {
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expectedSignature)
  );
}

📚 Documentação Interativa

Swagger/OpenAPI

Documentação completa das APIs

• Endpoints detalhados
• Exemplos de requisições
• Códigos de resposta
• Testes interativos

Postman Collection

Coleção para testes

• Requests pré-configurados
• Variáveis de ambiente
• Testes automatizados
• Documentação integrada

🆘 Suporte Técnico

Recursos Disponíveis

• Documentação completa
• Exemplos de código
• Fóruns da comunidade
• Suporte técnico

Contatos

• Email: dev@medpay.com.br
• Slack: #medpay-integrations
• Telefone: (11) 3000-0000
• Horário: 8h às 18h (seg-sex)

🚀 Próximos Passos

1. Configurar ambiente - Preparar integração
2. Testar APIs - Validar conectividade
3. Implementar webhooks - Receber eventos
4. Monitorar integração - Acompanhar performance