Receber

Pix, boleto, cartão e cripto pela mesma API, com QR Code pronto para exibir.

Rotear

Cada cobrança vai para o adquirente elegível, com failover automático se um cair.

Dividir

Split por percentual entre subcontas — ideal para marketplaces e coprodução.

Sacar

Saque Pix para CPF, CNPJ, e-mail ou chave aleatória, direto do saldo.

Integre com IA em segundos.

Escolha o objetivo, copie o prompt pronto e cole no ChatGPT, Claude, DeepSeek, Cursor ou Copilot. A IA escreve o código da integração na sua linguagem.

Atue como um Engenheiro de Software Sênior especialista em integrações financeiras e gateways de pagamento.
Preciso integrar o gateway de pagamento Skala Pay no meu projeto.

## Informações Gerais
- Gateway: Skala Pay
- Base URL: https://skalapay.net/api
- Formato: REST JSON
- Autenticação: toda requisição exige os headers HTTP:
  X-Client-Id: SEU_CLIENT_ID
  X-Client-Secret: SEU_CLIENT_SECRET
  Content-Type: application/json
  Accept: application/json

## 1. Criar Cobrança PIX (Cash-In)
- Endpoint: POST https://skalapay.net/api/cash-in
- Payload JSON:
{
  "amount": 100.00,
  "payment_method": "pix",
  "description": "Pagamento Pedido #1024",
  "customer_data": {
    "name": "Nome do Cliente",
    "email": "cliente@email.com",
    "document": "12345678909",
    "phone": "11999999999"
  }
}
- Resposta de sucesso: objeto transaction (id, order_id, status "PENDING") e acquirer_response com qr_code (Copia e Cola), qr_code_base64 e expires_at.

## 2. Consultar Status da Transação
- Endpoint: GET https://skalapay.net/api/cash-in/{transactionId}
- Status possíveis: PENDING, PROCESSING, PAID, FAILED, CANCELLED, REFUNDED, CHARGEBACK.

## 3. Receber Webhook de Confirmação
- Payload recebido:
{
  "event": "cashin.confirmed",
  "status": "paid",
  "transaction_id": 1420,
  "order_id": "CASHIN_...",
  "amount": "100.00",
  "paid_at": "2026-09-29T20:00:00Z"
}
- Processar de forma idempotente, marcar o pedido como pago e retornar HTTP 200 {"received": true}.

## 4. Saque / Transferência PIX (Cash-Out)
- Endpoint: POST https://skalapay.net/api/cash-out
- Payload JSON:
{
  "amount": 50.00,
  "payment_method": "pix",
  "pix_key": "chave_pix_destino",
  "pix_key_type": "CPF",
  "description": "Repasse ou Saque de Comissao"
}

## 5. Consultar Status do Saque
- Endpoint: GET https://skalapay.net/api/cash-out/{transactionId}

TAREFA:
Crie a implementação completa, limpa, tipada e com tratamento de erros na linguagem/framework do meu projeto:
1. Um serviço cliente HTTP SkalaPayService com timeout, headers e tratamento de exceções.
2. Uma rota criando a cobrança Pix e retornando o QR Code para o frontend.
3. Um controller de webhook recebendo a confirmação e aprovando o pedido com segurança.
4. Exemplo de chamada para realizar saque Pix.
5. Onde colocar as credenciais no arquivo .env.

Toda cobrança passa por estes status. Toque em cada um para ver o que significa e o que a sua integração deve fazer.