Documentação oficial da API Moneyfly. Gere PIX em 1 request, integre em 5 minutos.

Documentação da API Moneyfly

Gateway de pagamento brasileiro. PIX em 2 segundos, taxas honestas, API que não te faz chorar.

Aqui você encontra tudo pra integrar seu sistema ao Moneyfly e começar a receber PIX.

Como funciona

O Moneyfly é um gateway — você não precisa lidar com banco, BACEN ou homologação. A gente cuida da infraestrutura bancária e te entrega uma API REST simples.

Fluxo básico:

Cria uma conta em moneyflybr.com
Gera uma chave de API no painel (Integrações → Nova chave)
Chama POST /v1/pix/qrcode passando valor e dados do pagador
Mostra o QR Code pro seu cliente pagar
Recebe notificação via webhook quando o pagamento cai
Saca o saldo via POST /v1/pix/payout quando quiser

Primeiro PIX em 3 minutos

curl -X POST https://api.moneyflybr.com/v1/pix/qrcode \
  -H "client-id: mf_pk_live_SEU_CLIENT_ID" \
  -H "client-secret: mf_sk_live_SEU_CLIENT_SECRET" \
  -H "Idempotency-Key: venda-12345" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 9990,
    "payer": {
      "name": "João Silva",
      "document": "12345678909",
      "email": "joao@exemplo.com"
    }
  }'

Resposta (HTTP 201):

{
  "internal_id": "cl_abc123...",
  "external_id": null,
  "status": "pending",
  "amount": 9990,
  "fee_amount": 198,
  "net_amount": 9792,
  "qrcode": "00020126580014br.gov.bcb.pix...",
  "qr_image_url": "/v1/pix/qrcode/cl_abc123/image",
  "expires_at": "2026-04-24T19:00:00Z",
  "created_at": "2026-04-24T18:00:00Z"
}

Pegou o qrcode? Mostra pro cliente como texto copia-e-cola ou renderiza como QR Code. Quando ele pagar, chega um POST no seu webhook avisando.

Princípios da API

Valores sempre em centavos. amount: 9990 é R$ 99,90. Inteiro, sem dor de ponto flutuante.

Idempotência obrigatória em operações que movem dinheiro. Manda Idempotency-Key no header — se a gente receber duas vezes, processa uma só.

Erros em português e com códigos claros. Sem Error 500 misterioso. Veja códigos de erro.

Webhooks assinados. Todo POST que enviamos pro seu endpoint tem X-Moneyfly-Signature: sha256=... pra você verificar. Veja webhooks.

Dois ambientes

Ambiente	URL base	Chaves
Teste	`https://api.moneyflybr.com`	`mf_pk_test_` / `mf_sk_test_`
Produção	`https://api.moneyflybr.com`	`mf_pk_live_` / `mf_sk_live_`

A URL é a mesma — o que muda é o prefixo da chave. Chaves test_* geram QR Codes fake que não movem dinheiro real; usam pra validar integração.

Por onde seguir

Autenticação — headers client-id + client-secret
PIX — Depósitos — gerar QR Code pro cliente pagar
PIX — Saques — mandar dinheiro pra qualquer chave
PIX — Multi-splits — dividir pagamento entre várias contas
Webhooks — receber notificação quando algo muda
Idempotência — evitar cobrança duplicada

Suporte

WhatsApp 24h: clique pra falar com a gente
Email: suporte@moneyflybr.com

Visão geral