Documentação API | ICE PAY TECNOLOGIA

Documentação · v2

Início rápido

API Pix da ICE PAY TECNOLOGIA — uma única integração para criar cobranças, processar pagamentos e receber confirmações em tempo real, 24/7.

POST/v2/transactions/cashin

Cash-in Pix

Ver detalhes

POST/v2/transactions/cashout

Cash-out Pix

Autenticação

Webhooks

Integre em 3 passos

O fluxo é o mesmo para qualquer operação: autentique → execute → receba o webhook.

Autentique-se em POST /v2/oauth/token com seu client_id e client_secret e receba um access_token válido por 1 hora.
Execute a operação usando o token em qualquer endpoint da API. Mesmo padrão de request/response.
Receba a confirmação via webhook na sua postback_url assim que o pagamento for liquidado.

Endpoint base

Todas as requisições devem ser feitas via HTTPS para o domínio:

HTTP

https://api.icepay.tech

OAuth 2.0

Autenticação

Use Basic Auth com suas credenciais para obter um token de acesso:

cURL

curl -X POST https://api.icepay.tech/v2/oauth/token \
  -H "Authorization: Basic $(echo -n 'CLIENT_ID:CLIENT_SECRET' | base64)"

Resposta:

JSON

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "meta": {
    "request_id": "req_93e93fccf4e741",
    "timestamp": "2026-04-30T14:23:37Z"
  }
}

Endpoint

Sua primeira cobrança Pix

Uma única chamada gera o QR Code, o código copia-e-cola e o ID da transação:

cURL

curl -X POST https://api.icepay.tech/v2/transactions/cashin \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 149.90,
    "external_id": "pedido_001",
    "payer": { "name": "João Silva", "document": "12345678900" },
    "postback_url": "https://seusite.com/webhook"
  }'

Resposta com os dados do Pix:

JSON

{
  "data": {
    "transaction_id": "tx_49c498a9c5ec5e7d3202",
    "external_id": "pedido_001",
    "amount": 149.90,
    "status": "pending",
    "payment_info": {
      "qrcode": "00020126580014BR.GOV.BCB.PIX...",
      "qrcode_image": "data:image/png;base64,iVBORw0KGgoAAAANSUhE...",
      "expires_at": "2026-04-30T15:23:37Z"
    }
  }
}

Endpoint

Cash-out Pix

Envie para qualquer chave Pix em segundos, sem intermediários:

cURL

curl -X POST https://api.icepay.tech/v2/transactions/cashout \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 250.00,
    "external_id": "saque_001",
    "pix_key": { "type": "email", "value": "destino@empresa.com" },
    "postback_url": "https://seusite.com/webhook"
  }'

Tempo real

Webhook de confirmação

Pagamento recebido? A ICE PAY dispara um POST automático para sua postback_url. Sem polling, sem fila para gerenciar.

JSON

{
  "event": "cashin.paid",
  "transaction_id": "tx_49c498a9c5ec5e7d3202",
  "external_id": "pedido_001",
  "amount": 149.90,
  "status": "paid",
  "paid_at": "2026-04-30T14:25:18Z"
}

Responda HTTP 200 para confirmar o recebimento. Em caso de falha, reenviamos até 5 vezes com backoff exponencial. Toda chamada é assinada com HMAC SHA-256.

Próximos passos

Pronto para integrar?

Solicite credenciais de homologação com o time comercial e comece a testar em minutos.

Falar com comercial Voltar ao site