1. Transações
SYNC-DOCUMENTATION
  • Introdução
  • Auth Token
    • Gera o token de utilização da aplicação
      POST
  • Saldo
    • Retorna o Saldo do Usuário
      GET
  • Transações
    • Consultar transação V1
      GET
    • Consultar transação V2
      GET
  • Utmify
    • Salvar Token
      POST
    • Desativa Token
      POST
  • Partner
    • Consulta dados do Parceiro
      GET
  • Cartão de Crédito
    • Selar um cartão
      POST
    • Cobrar no cartão
      POST
  • Pix - CashIn
    • Solicitação de depósito via Pix
      POST
  • Old API
    • CashIn
      POST
    • Consulta os dados do Parceiro
      GET
  • Assinaturas - Recorrência
    • Assinatura com Cartão de Crédito
    • Planos
      • Listar planos
      • Criar plano
      • Detalhe do plano
      • Editar plano
      • Arquivar plano
      • Assinantes do plano
    • Assinantes
      • Cadastrar assinante
      • Listar assinantes
      • Detalhe da assinatura
      • Cancelar assinatura
      • Pausar assinatura
      • Reativar assinatura
      • Reenviar cobrança
      • Trocar plano da assinatura
    • Notificações
      • Listar entregas de um webhook
    • Splits
      • Adicionar recebedor de split a um plano
      • Listar splits enviados (perspectiva do seller)
      • Listar convites recebidos (perspectiva do recebedor)
      • Aceitar convite de split
      • Rejeitar convite de split
      • Cancelar split (perspectiva do seller)
    • Produtos — Planos
      • Listar planos aninhados a um produto
      • Criar plano aninhado a um produto
      • Atualizar plano aninhado
      • Desativar plano aninhado
      • Marcar plano como padrão do produto
  • Reembolsos
    • Solicitar reembolso de uma venda
      POST
    • Consultar uma solicitação de reembolso
      GET
  • Raiz
  • Webhooks
    • Cash-In
      • Cash-in criado (cobrança PIX gerada)
      • Cash-in atualizado (mudança de status)
      • Cash-in legado (notificação mínima)
    • Cash-Out
      • Cash-out criado (saque solicitado)
      • Cash-out atualizado (mudança de status do saque)
    • Cartão de Crédito
      • Cartão de crédito — cobrança criada
      • Cartão de crédito — mudança de status
    • Transações - Completo
      • Cobrança de transação criada
      • Transação teve mudança de status
    • Listar webhooks
    • Criar webhook
    • Atualizar webhook
    • Excluir webhook
    • Rotacionar o segredo de assinatura
  • Esquemas
    • Webhook
      • CashIn
        • onCreate
        • onUpdate
        • CashinCreated
        • CashinUpdated
        • CashinOld
      • CashOut
        • onCreate
        • onUpdate
      • Cash-In
        • CashinCreated
        • CashinUpdated
        • CashinOld
    • CreditCardCreatePayload
    • CashoutCreated
    • CreditCardCreated
    • WebhookInput
    • CashinCreated
    • CardTokenRequest
    • RefundReason
    • BillingMethod
    • Message
    • TransactionEvent
    • CardToken
    • RefundStatus
    • CashinUpdated
    • CreditCardUpdated
    • CreditCardStatusPayload
    • CashoutUpdated
    • TransactionV2
    • PlanStatus
    • Webhook
    • Customer
    • RefundRejectionCategory
    • Transaction
    • RefundWebhookPayload
    • CreditCardPaymentRequest
    • CreatedWebhook
    • CashinOld
    • SplitStatus
    • WebhookListItem
    • CreditCardPaymentAccepted
    • SubscriptionSplit
    • DebtorAccount
    • PaymentMethod
    • SimpleError
    • RefundRequest
    • WebhookDelivery
    • SplitRecipientPayload
    • Payment
    • RotatedWebhookSecret
    • RefundTransaction
    • SubscriptionSplitInvite
    • StoreProductPlanRequest
    • CodedError
    • RefundEvent
    • SubscriptionStatus
    • UpdateProductPlanRequest
    • Checkout
    • Card
    • RefusedError
    • PaymentLink
    • ChargeStatus
    • AntiFraudError
    • Tracking
    • Error
    • DeliveryAddress
    • ValidationError
    • PlanResource
    • PaginationMeta
    • ChargeResource
    • SubscriptionResource
    • EnrollPaymentQrCode
    • EnrollPaymentPixAutomatico
    • WebhookResource
    • NotFoundError
    • WebhookEnvelope
    • ChargeBlock
    • MandateBlock
    • WebhookDeliveryResource
  1. Transações

Consultar transação V2

GET
/api/partner/v2/transactions/{reference_id}
Retorna a venda identificada por reference_id, desde que pertença ao
seller autenticado.
A resposta é idêntica (404) para uma transação inexistente, de outro
seller ou que não seja venda (saque, split, comissões e taxas internas) —
não é possível enumerar identificadores.

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros de Caminho

Respostas

🟢200
application/json
Transação encontrada.
Bodyapplication/json

🟠401
🟠404
🟠422
🟠429
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/partner/v2/transactions/' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Venda PIX via checkout, com endereço de entrega
{
    "data": {
        "transaction": {
            "reference_id": "9f3c2a7e-5b1d-4c8e-a2f0-7d6b1e4c9a31",
            "status": "completed",
            "payment_method": "pix",
            "origin": "checkout",
            "description": "Curso de Tráfego Pago",
            "currency": "BRL",
            "amount": 197,
            "net_amount": 184.66,
            "refused_reason": null,
            "end_to_end_id": "E18236120202608161432s0123456789",
            "created_at": "2026-08-16T14:30:02Z",
            "updated_at": "2026-08-16T14:32:10Z",
            "paid_at": "2026-08-16T14:32:10Z",
            "refunded_at": null
        },
        "customer": {
            "reference_id": "0191a2b3-c4d5-7e6f-8a9b-0c1d2e3f4a5b",
            "name": "Fulano da Silva",
            "email": "fulano@email.com",
            "document": "12345678909",
            "phone": "+5511999998888"
        },
        "debtor_account": {
            "name": "FULANO DA SILVA",
            "document": "***.456.789-**",
            "issuer": "NU PAGAMENTOS S.A.",
            "account_type": "CACC"
        },
        "payment": {
            "pix": {
                "code": "00020126580014BR.GOV.BCB.PIX0136..."
            },
            "card": null
        },
        "checkout": {
            "reference_id": "0191a2b3-0000-7e6f-8a9b-0c1d2e3f4a5b",
            "name": "Checkout Black",
            "items": [
                {
                    "reference_id": "0191a2b3-1111-7e6f-8a9b-0c1d2e3f4a5b",
                    "name": "Curso de Tráfego Pago",
                    "type": "product",
                    "amount": 147
                },
                {
                    "reference_id": "0191a2b3-2222-7e6f-8a9b-0c1d2e3f4a5b",
                    "name": "Planilha de Campanhas",
                    "type": "order_bump",
                    "amount": 50
                }
            ]
        },
        "payment_link": null,
        "delivery_address": {
            "zip_code": "01310100",
            "street": "Av. Paulista",
            "number": "1000",
            "complement": "apto 12",
            "neighborhood": "Bela Vista",
            "city": "São Paulo",
            "state": "SP"
        },
        "tracking": {
            "utm": {
                "utm_source": "facebook",
                "utm_medium": "cpc",
                "utm_campaign": "lancamento",
                "utm_content": null,
                "utm_term": null,
                "src": null,
                "sck": null
            },
            "pixel": {
                "fbp": "fb.1.1755354600.123456789",
                "fbc": null,
                "ttclid": null,
                "ttp": null,
                "event_id": null,
                "external_id": null
            },
            "page_url": "https://checkout.seller.com/p/curso",
            "referrer": "https://facebook.com/",
            "client_ip": "200.150.10.2",
            "user_agent": "Mozilla/5.0"
        }
    }
}
Modificado em 2026-09-14 14:32:54
Página anterior
Consultar transação V1
Próxima página
Salvar Token
Built with