Pular para o conteúdo principal

​
Sua primeira cobranca PIX

Siga este guia para criar sua primeira cobranca PIX em poucos minutos.
1

Obtenha suas credenciais

Acesse o Painel Safefy e crie uma credencial de API.Voce recebera:
  • clientId - Identificador publico da sua aplicacao
  • clientSecret - Chave secreta (exibida apenas uma vez, mantenha em seguranca!)
2

Gere um token de acesso

Com suas credenciais, solicite um token JWT:
curl -X POST https://api-payment.safefypay.com.br/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grantType": "client_credentials",
    "clientId": "pk_sandbox_seu_client_id",
    "clientSecret": "sk_sandbox_seu_client_secret"
  }'
Resposta:
{
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIs...",
    "tokenType": "Bearer",
    "expiresIn": 3600
  }
}
3

Crie uma cobranca PIX

Use o token para criar sua primeira cobranca:
curl -X POST https://api-payment.safefypay.com.br/v1/transactions \
  -H "Authorization: Bearer {seu_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "pix",
    "amount": 1000,
    "currency": "BRL",
    "description": "Minha primeira cobranca",
    "callbackUrl": "https://seusite.com/webhook"
  }'
Resposta:
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "Pending",
    "amount": 1000,
    "pix": {
      "qrCode": "data:image/png;base64,...",
      "copyAndPaste": "00020126580014br.gov.bcb.pix..."
    }
  }
}
4

Receba o pagamento

Quando o pagamento for confirmado, voce recebera um webhook na URL configurada:
{
  "event": "transaction.completed",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "Completed",
    "amount": 1000,
    "completedAt": "2024-01-15T10:30:00Z"
  }
}

​
Proximos passos

Autenticacao

Entenda como funciona a autenticacao OAuth2.

Webhooks

Configure notificacoes em tempo real.

Sandbox

Teste pagamentos em ambiente de desenvolvimento.

Criar transacao

Veja a referencia completa do endpoint.