Cobre no Pix em duas chamadas

Sua chave

Pegue a chave da sua conta no painel, em Configurações → API Keys. Ela vai no header de toda chamada, ou no campo api_key do corpo — tanto faz.

x-api-key: tiggerpay_apikey_SUA_CHAVE

A chave identifica sua conta. Quem tiver ela cria cobranças no seu nome, então não publique no código do site. Para sacar dinheiro a chave não basta: o saque também exige o seu PIN.

Criar cobrança

Mande o valor em centavos e quem está pagando. A resposta traz o copia e cola para mostrar na tela e o txid, que é como você acompanha essa cobrança depois.

curl -X POST https://api.tiggerpayments.com/create-pix-duck \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1990,
    "api_key": "tiggerpay_apikey_SUA_CHAVE",
    "description": "Pedido #123",
    "customer": {
      "name": "Maria Silva",
      "email": "maria@email.com",
      "cellphone": "11999999999",
      "taxId": "12345678900"
    }
  }'

{
  "pix_code": "00020101021226820014br.gov…",
  "pix_qr_code": "00020101021226820014br.gov…",
  "txid": "a1b2c3d4"
}

amount em centavos: 1990 é R$ 19,90. name e email do cliente são obrigatórios. Se você mandar product_id, as integrações daquele produto (pixels, webhook) disparam junto.

Confirmar pagamento

Enquanto o QR Code estiver na tela, pergunte pelo txid a cada 4 ou 5 segundos. Quando voltar approved, libere o pedido.

curl https://api.tiggerpayments.com/api/verificar-pix/a1b2c3d4 \
  -H "x-api-key: tiggerpay_apikey_SUA_CHAVE"

{ "status": "approved", "txid": "a1b2c3d4", "valor": 19.90 }

Se preferir ser avisado em vez de perguntar, cadastre uma URL em Configurações → Webhooks e a TiggerPay envia um POST assim que o pagamento entra. O webhook é um aviso: confirme o valor final consultando as vendas.

Rastreamento de anúncio

Para a compra voltar para a Meta, o TikTok, o Google ou o Kwai com o clique certo (Dracofy, UTMify e parecidos), mande o clique do anúncio junto da cobrança. Todos os campos são opcionais e vão no nível de cima do corpo, ao lado de amount. Mande só os que existirem, com o valor original, sem inventar.

{
  "amount": 4750,
  "api_key": "tiggerpay_apikey_SUA_CHAVE",
  "customer": { "name": "Maria Silva", "email": "maria@email.com" },
  "fbc": "fb.1.1759500000000.IwAR0abc",
  "fbp": "fb.1.1759500000000.123456789",
  "click_id": "IwAR0abc",
  "utm_source": "facebook",
  "utm_campaign": "campanha-maio"
}

{
  "id": "a1b2c3d4",
  "status": "paid",
  "amount": 47.50,
  "tracking": {
    "fbc": "fb.1.1759500000000.IwAR0abc",
    "fbp": "fb.1.1759500000000.123456789",
    "click_id": "IwAR0abc",
    "utm_source": "facebook",
    "utm_campaign": "campanha-maio"
  },
  "buyer_user_agent": "Mozilla/5.0 …"
}

O bloco tracking volta igual no aviso de pendente e no de pago. Dracofy: copie a URL de webhook do seu projeto na Dracofy e cadastre em Configurações → Webhooks. Tem mais de um projeto? Cadastre uma URL para cada.

Split de pagamento

O split manda uma parte de cada venda para o saldo de outra conta TiggerPay — por exemplo, a comissão de quem fez a integração ou de um parceiro. É só incluir estes campos no mesmo corpo do /create-pix-duck:

Use split_valor ou split_percentual. Se mandar os dois, vale o split_valor.

curl -X POST https://api.tiggerpayments.com/create-pix-duck \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 10000,
    "api_key": "tiggerpay_apikey_CHAVE_DO_SELLER",
    "description": "Pedido #123",
    "customer": { "name": "Maria Silva", "email": "maria@email.com" },
    "split_para": "tiggerpay_apikey_CHAVE_DE_QUEM_RECEBE",
    "split_percentual": 10
  }'

Nesse exemplo, numa venda de R$ 100,00, R$ 10,00 vão para a conta de split_para e o restante do líquido fica com o seller.

• Quem recebe só precisa ter uma conta na TiggerPay. Não tem nada para ativar: basta usar a chave de API dessa conta em split_para. Se a chave não existir, a cobrança é criada normalmente, sem split.
• Mande os campos em toda cobrança. O split não fica salvo na conta: cobrança criada sem eles não tem split.
• O split sai do valor líquido do seller (depois das taxas), não da taxa da TiggerPay, e nunca passa do líquido da venda.
• O valor só é creditado quando a venda é paga. Ele entra no saldo disponível de quem recebe, que saca normalmente pelo painel.
• split_para não pode ser a mesma chave de quem está cobrando.

Quem recebe o split: sua chave vai ficar no sistema de quem integra, então cadastre o PIN de saque em Configurações → Segurança. A chave sozinha não saca dinheiro, mas permite consultar suas vendas e seu saldo.

Todas as rotas

Erros

A documentação completa, com a sua chave já preenchida nos exemplos, fica no painel: tiggerpayments.com → Configurações → API Keys.