Endpoints da API

🔗 Base URL

Production: https://api.paymentgateway.com
Development: http://localhost:3000/api

💳 Payments

Criar Pagamento

POST /api/v1/payments
Content-Type: application/json
Authorization: Bearer {token}

{
  "amount": 100.00,
  "currency": "BRL",
  "payment_method": "credit_card",
  "customer": {
    "email": "[email protected]",
    "name": "João Silva"
  },
  "card": {
    "number": "4111111111111111",
    "exp_month": 12,
    "exp_year": 2025,
    "cvc": "123"
  }
}

Resposta:

{
  "success": true,
  "data": {
    "id": "pay_12345",
    "status": "processing",
    "amount": 100.00,
    "currency": "BRL",
    "created_at": "2024-12-12T10:30:00Z"
  }
}

Obter Pagamento

GET /api/v1/payments/{id}
Authorization: Bearer {token}

Listar Pagamentos

GET /api/v1/payments?status=succeeded&limit=20&page=1
Authorization: Bearer {token}

Reembolsar Pagamento

POST /api/v1/payments/{id}/refund
Content-Type: application/json
Authorization: Bearer {token}

{
  "amount": 50.00,
  "reason": "requested_by_customer"
}

🔐 Authentication

Login

POST /api/v1/auth/login
Content-Type: application/json

{
  "email": "[email protected]",
  "password": "password123"
}

Refresh Token

POST /api/v1/auth/refresh
Content-Type: application/json

{
  "refresh_token": "rt_abc123"
}

🎣 Webhooks

Receber Webhook

POST /webhooks/{provider}
Content-Type: application/json
X-Signature: {signature}

{
  "type": "payment.succeeded",
  "data": { /* event data */ }
}

📊 Monitoring

Métricas do Sistema

GET /api/monitoring/metrics
Authorization: Bearer {token}

Status dos Provedores

GET /api/monitoring/providers
Authorization: Bearer {token}

Alertas

GET /api/monitoring/alerts
Authorization: Bearer {token}

⚙️ Admin

Configurações

GET /api/admin/config
Authorization: Bearer {admin_token}

PUT /api/admin/config
Content-Type: application/json
Authorization: Bearer {admin_token}

{
  "rate_limiting": {
    "enabled": true,
    "max_requests": 1000
  }
}

---

Documentação atualizada: December 2024