POST
/transactionsEscopo: payments.createCriar cobrança
Cria uma cobrança PIX e retorna o QR Code (base64) e o código copia-e-cola para o pagador. O valor é sempre em centavos.
Parâmetros
amountbodyobrigatório- integer: Valor em centavos (mín. 100 = R$ 1,00). Ex.: 1490 = R$ 14,90.
webhookbody- string: URL para notificar quando o pagamento for aprovado (sobrescreve o webhook global desta cobrança).
split_emailbody- string: E-mail de outra conta SyntraPay para dividir o valor (split).
split_taxbody- integer: Percentual destinado ao parceiro no split (1 a 99, padrão 50).
customerbody- object: Dados do pagador para rastreio (name, document). Opcional.
productsbody- array: Itens da venda, usados por integrações de tracking (ex.: Utmify).
trackingParametersbody- object: UTMs da campanha (utm_source, utm_medium, etc.).
Idempotency-Keyheader- string: Chave única sua para evitar cobranças duplicadas em reenvios. A resposta é repetida por 24h para a mesma chave.
Campos da resposta
id- string: Identificador único da cobrança.
status- string: Status inicial (pending).
amount- integer: Valor da cobrança em centavos.
qrCodeBase64- string: Imagem do QR Code em data URI (base64).
copyPaste- string: Código PIX copia-e-cola.
expiresAt- string: Data/hora de expiração (ISO 8601).
fee- integer: Taxa aplicada em centavos.
storeId- string: Identificador da sua conta.
Requisição
curl -X POST "https://api.syntrapay.com.br/transactions" \
-H "Authorization: sk_live_sua_chave_aqui" \
-H "Content-Type: application/json" \
-d '{"amount":1490}'Resposta
201 Created{
"message": "Transaction created successfully",
"status": "pending",
"id": "9c1e7b2a-3f4d-4a8b-bc12-5e6f7a8b9c0d",
"amount": 1490,
"qrCodeBase64": "data:image/png;base64,iVBORw0KGgoAAA...",
"copyPaste": "00020126580014br.gov.bcb.pix...6304ABCD",
"expiresAt": "2026-07-18T15:30:00.000Z",
"fee": 44,
"storeId": "usr_a1b2c3"
}400 Bad Request
{
"status": "error",
"code": "BAD_REQUEST",
"message": "400: Amount must be at least 100 cents (R$ 1,00)"
}