Comprovante de Transação Bancária

Gera o comprovante em PDF de uma transação bancária (Pix, TED, transferência entre contas Conta Simples ou pagamento de boleto) e retorna uma URL assinada de curta duração para download.

Regras:

Só há comprovante para transações com status PROCESSADO (status: 2).
Verifique o campo showReceipt da transação (no extrato bancário) antes de chamar — ele indica se a operação gerou comprovante.
A URL de download é assinada e expira em 5 minutos (veja expiresAt); faça uma nova requisição caso ela expire.
Tipos de transação sem comprovante suportado retornam 404.

curl -X GET "https://api-sandbox.contasimples.com/statements/v1/banking/106615/receipt" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests
import json

url = "https://api-sandbox.contasimples.com/statements/v1/banking/106615/receipt"
headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://api-sandbox.contasimples.com/statements/v1/banking/106615/receipt", {
  method: "GET",
  headers: {
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_TOKEN"
}
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
)

func main() {

    req, err := http.NewRequest("GET", "https://api-sandbox.contasimples.com/statements/v1/banking/106615/receipt", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://api-sandbox.contasimples.com/statements/v1/banking/106615/receipt')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'

response = http.request(request)
puts response.body

{
  "downloadUrl": "https://banking-transaction-receipts.s3.amazonaws.com/company-id/106615.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=300&X-Amz-Signature=...",
  "expiresAt": "2026-07-16T18:52:50.000Z"
}

{
  "error": "Bad Request",
  "message": "Um ou mais parâmetros da requisição são inválidos.",
  "code": 400,
  "requestId": "123e4567-e89b-12d3-a456-426614174000",
  "details": [
    "O campo exemplo deve ter um valor entre 5 e 100.",
    "datas devem estar no formato YYYY-MM-DD."
  ]
}

GET

/statements/v1/banking/{transactionId}/receipt

GET

Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token

Bearer Tokenstring

Required

Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN

path

transactionIdinteger

Required

ID da transação bancária, obtido no array transactions da resposta do extrato bancário.

Request Preview

Response

Response will appear here after sending the request

Authentication

header

Authorizationstring

Required

Bearer token. Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN

Path Parameters

transactionIdinteger

Required

ID da transação bancária, obtido no array transactions da resposta do extrato bancário.

Example:

106615

Responses

downloadUrlstring

Required

URL assinada de curta duração para baixar o PDF do comprovante.

expiresAtstring

Required

Data e hora (ISO 8601) em que a URL de download expira (padrão: 5 minutos após a geração).

Was this page helpful?