Baixar comprovante de transacao

Caso de uso

Use este endpoint para disponibilizar ao seu ERP, checkout ou atendimento o comprovante digital oficial de uma transacao paga. O arquivo retornado e um PDF com identidade TurbofyPay, dados de pagador, dados de recebedor, valor, data, identificadores de rastreabilidade e QR de validacao.

Endpoint

GET /v1/receipts/transactions/{id}

Alias aceito para integracoes que usam o termo cobranca:

GET /v1/receipts/charges/{id}

Autenticacao

Headers obrigatorios:

x-client-id
x-client-secret
x-turbofy-timestamp
x-turbofy-signature

A chave de API precisa estar ativa e pertencer ao merchant dono da transacao.

Identificador aceito

O {id} pode ser qualquer identificador da cobranca/transacao persistido pela Turbofy para o merchant autenticado:

id da cobranca Turbofy
externalRef
providerChargeId
pixTxid
endToEndId
providerTransactionId

Use o mesmo valor no path assinado. Exemplo: se baixar por endToEndId, assine /v1/receipts/transactions/{endToEndId}.

Assinatura HMAC

Assine a requisicao usando:

{timestamp}.GET./v1/receipts/transactions/{id}.

Em requisicoes GET, o corpo assinado e vazio. Gere uma assinatura nova para cada download.

Response de sucesso

Em 200, a API retorna:

Content-Type: application/pdf
Content-Disposition: inline; filename="comprovante-transacao-{id}.pdf"
Cache-Control: private, no-store
corpo binario do PDF

Erros comuns

HTTP	code	Quando ocorre
`400`	`VALIDATION_ERROR`	Identificador invalido.
`401`	`INVALID_CREDENTIALS`	Credenciais ausentes ou invalidas.
`401`	`INVALID_SIGNATURE`	Assinatura ausente, invalida ou expirada.
`404`	`NOT_FOUND`	Transacao inexistente para o merchant autenticado.
`409`	`RECEIPT_UNAVAILABLE`	Transacao ainda nao esta paga.

Exemplo de codigo

curl --request GET \
  --url https://api.turbofypay.com/v1/receipts/transactions/2e97e17c-f636-4580-b29c-059f39319200 \
  --header "x-client-id: <client-id>" \
  --header "x-client-secret: <client-secret>" \
  --header "x-turbofy-timestamp: 1772805000000" \
  --header "x-turbofy-signature: <hmac-sha256>" \
  --output comprovante-transacao.pdf

Regras de negocio

A consulta retorna somente comprovantes do merchant autenticado.
O PDF nao deve ser armazenado em cache publico.
O comprovante e gerado pela TurbofyPay com dados financeiros e rastreabilidade Pix disponiveis no momento da emissao.
Para transacoes antigas, se o endToEndId estiver apenas no registro de transacao Pix vinculado, a API resolve esse vinculo antes de gerar o PDF.
Para validar assinatura HMAC, revise Autenticacao.

Cobranca PIX

Payouts

Saques

Comprovantes

Baixar comprovante de transacao

Caso de uso

Endpoint

Autenticacao

Identificador aceito

Assinatura HMAC

Response de sucesso

Erros comuns

Exemplo de codigo

Regras de negocio

​Caso de uso

​Endpoint

​Autenticacao

​Identificador aceito

​Assinatura HMAC

​Response de sucesso

​Erros comuns

​Exemplo de codigo

​Regras de negocio

Caso de uso

Endpoint

Autenticacao

Identificador aceito

Assinatura HMAC

Response de sucesso

Erros comuns

Exemplo de codigo

Regras de negocio