Quickstart
Vamos criar uma cobrança PIX em um workflow e ler o QR Code na saída do nó.
Vamos criar uma cobrança PIX em um workflow e ler o QR Code na saída do nó.
1. Adicione o nó Selectwin
Crie um workflow novo, adicione o nó Selectwin e selecione a credencial configurada na Instalação.
2. Configure a cobrança
- Resource:
Transaction· Operation:Create - Amount: valor em centavos — ex.:
2500para R$ 25,00 (mínimo500). - Method:
PIX(defina a validade do QR em PIX Expires In (Minutes) se quiser). - Customer: informe um
Customer IDexistente (cus_…) ou os dados inline — nome, sobrenome e e-mail. Com dados inline a API faz find-or-create do cliente. - Opcional: Description, External Reference (ex.: o ID do pedido no seu sistema) e Additional Fields (JSON mesclado ao corpo da requisição).
3. Execute e leia a saída
Execute o nó. A resposta é a transação completa; os campos do PIX vêm em payment:
{
"id": "tra_…",
"status": "pending",
"payment": {
"pixQrCodeEmv": "00020101021226…",
"pixQrCodeUrl": "https://…",
"pixQrCodeImage": "https://…"
}
}Use pixQrCodeEmv (copia e cola) ou pixQrCodeImage nos nós seguintes — envie por e-mail, WhatsApp, Slack, ou grave no seu banco de dados.
Não faça polling de GET /v1/transactions/:id em loop para saber se pagou — a API proíbe polling. Use o Selectwin Trigger com o evento transaction.approved: veja Trigger & webhooks.
Outras operações
O mesmo nó cobre os fluxos quentes da API — alguns exemplos:
| Resource | Operações |
|---|---|
| Transaction | Create · Get · Get All (filtros por status/método/cliente) · Refund · Capture |
| Customer | Create · Get · Get All · Update · Delete |
| Payment Link | Create (a URL compartilhável volta em accessFullUrl) · Get · Get All · Update · Delete |
| Product / Variant | CRUD de produtos · listagem de variantes |
| Subscription | Get · Get All · Cancel · Pause · Resume |
| Balance | Get · History |
Toda operação de criação envia X-Idempotency-Key automaticamente — repetições acidentais não geram cobrança duplicada (veja Idempotência).
Qualquer outro endpoint
Para endpoints sem operação curada, use o Custom API Call do próprio nó, ou o nó HTTP Request do n8n escolhendo Selectwin API como credencial predefinida — o header selectkey é injetado automaticamente.
How is this guide?