Consultar transações do VCN (Em breve)
🚧 Em breve — este endpoint ainda não está disponível em Sandbox nem Produção. A documentação está publicada para você preparar a integração; avisaremos no changelog quando entrar no ar.
Use para conciliar os pagamentos de uma reserva: lista as transações de um VCN, identificado pelo vcnId retornado em Criar VCN. Resultado paginado e ordenado por data decrescente.
Autenticação: além da API key/secret, este endpoint exige mTLS na camada de transporte.
Autorização: o vcnId precisa pertencer ao cliente autenticado; um vcnId de outro cliente retorna 404.
curl -X GET "https://api-sandbox.contasimples.com/credit-cards/v1/vcns/21624502/transactions?limit=50&startDate=2026-06-01&endDate=2026-06-30&status=%5B%22AUTHORIZED%22%5D&nextPageStartKey=example_string" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
import requests
import json
url = "https://api-sandbox.contasimples.com/credit-cards/v1/vcns/21624502/transactions?limit=50&startDate=2026-06-01&endDate=2026-06-30&status=%5B%22AUTHORIZED%22%5D&nextPageStartKey=example_string"
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/credit-cards/v1/vcns/21624502/transactions?limit=50&startDate=2026-06-01&endDate=2026-06-30&status=%5B%22AUTHORIZED%22%5D&nextPageStartKey=example_string", {
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/credit-cards/v1/vcns/21624502/transactions?limit=50&startDate=2026-06-01&endDate=2026-06-30&status=%5B%22AUTHORIZED%22%5D&nextPageStartKey=example_string", 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/credit-cards/v1/vcns/21624502/transactions?limit=50&startDate=2026-06-01&endDate=2026-06-30&status=%5B%22AUTHORIZED%22%5D&nextPageStartKey=example_string')
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
{
"transactions": [
{
"transactionId": "txn_01HF8Z3K2QX5",
"status": "SETTLED",
"amount": {
"value": 101,
"currency": "BRL"
},
"date": "2026-06-09T16:02:40Z",
"merchantName": "CIA AEREA EXEMPLO",
"merchantCategory": "AIR",
"authorizationCode": "A1B2C3"
}
],
"nextPageStartKey": "eyJsYXN0SWQiOiJ0eG5fMDFIRjhaIn0="
}
{
"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."
]
}
{
"error": "Unauthorized",
"message": "Token de acesso inválido ou expirado.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 401
}
{
"error": "Forbidden",
"message": "Você não tem permissão para realizar esta operação.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 403
}
{
"error": "Not Found",
"message": "O recurso solicitado não foi encontrado.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 404
}
{
"error": "Internal Server Error",
"message": "Ocorreu um erro inesperado ao processar a solicitação.",
"requestId": "123e4567-e89b-12d3-a456-426614174000",
"code": 500
}
/credit-cards/v1/vcns/{vcnId}/transactionsTarget server for requests. Edit to use your own host.
Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN
Bearer TOKENIdentificador do VCN retornado na emissão (campo vcnId).
Número máximo de transações por página. Mínimo: 1, Máximo: 100. Padrão: 50.
Data inicial do período consultado (formato YYYY-MM-DD).
Data final do período consultado (formato YYYY-MM-DD).
Filtro opcional por situação da transação.
Token opaco de paginação retornado na resposta anterior. Use exatamente como recebido para obter a próxima página.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN
Path Parameters
Query Parameters
Filtro opcional por situação da transação.
Token opaco de paginação retornado na resposta anterior. Use exatamente como recebido para obter a próxima página.
Responses
Token opaco de paginação. Reenvie no parâmetro nextPageStartKey para obter a próxima página. Ausente na última página.