> ## Documentation Index > Fetch the complete documentation index at: https://docs.pay.v4companyamaral.com/llms.txt > Use this file to discover all available pages before exploring further. # Dados do comprovante (público) > Rota pública usada pela página de checkout e pelo comprovante. Devolve a cobrança com o documento do pagador **mascarado no servidor** e o nome/CNPJ da loja que recebe. ## OpenAPI ````yaml /openapi.yaml get /checkout/{txid} openapi: 3.1.0 info: title: V4Pay API version: 2.0.0 description: > API do gateway de pagamentos V4Pay: autenticação, clientes, cobranças, cupons e emissão de Pix — cada lojista tem uma conta de recebimento no CNPJ dele, e a cobrança leva um split com a taxa do V4 Pay. Todas as rotas protegidas usam token JWT — o usuário é identificado pelo token, nunca por `user_id` no corpo da requisição. servers: - url: https://v4pay-api.vercel.app description: Produção. - url: http://localhost:3000 description: Ambiente local de desenvolvimento. security: [] tags: - name: Pix description: Emitir e consultar cobranças Pix — o coração da API. - name: Cobranças description: Registro direto de cobranças e a listagem do histórico da loja. - name: Clientes description: Cadastro de pagadores para reutilizar nas cobranças. - name: Links de pagamento description: URLs públicas reutilizáveis que abrem o checkout com o valor definido. - name: Checkout (público) description: >- As rotas que a página de pagamento usa — sem autenticação, o pagador não tem conta. - name: Produtos description: Catálogo da loja; um produto pode virar cobrança ou link. - name: Cupons description: Descontos aplicados no checkout e na emissão por produto. - name: Assinaturas description: Cobrança recorrente, gerada por um cron diário. - name: Webhooks (endpoints) description: >- As URLs do seu servidor que recebem os eventos da loja, com assinatura HMAC. - name: Chaves de API description: Credenciais de integração (v4pay_test_ / v4pay_live_), revogáveis. - name: Conta de recebimento description: Cadastro da empresa e a conta que recebe — vale no modo subconta. - name: Aprovação de produção description: >- O fluxo para liberar a operação em produção — dados da empresa, documentos e análise da equipe. - name: Saques description: >- Pedidos de saque do saldo — suspensos no modo conta única (REPASSE_MANUAL). - name: Membros da loja description: Convites e papéis de quem opera a loja junto com o dono. - name: Conta (auth) description: Cadastro, login, perfil e a troca de ambiente da sessão. - name: Auditoria description: Trilha das ações feitas na loja, com quem fez e de onde. - name: Sistema description: Saúde da API. - name: Interno description: >- USO INTERNO DO PAINEL — documentado por transparência, não para integração: pode mudar sem aviso (Roadmap, aprovações da equipe, cron, login com Google, onboarding). paths: /checkout/{txid}: get: tags: - Checkout (público) summary: Dados do comprovante (público) description: > Rota pública usada pela página de checkout e pelo comprovante. Devolve a cobrança com o documento do pagador **mascarado no servidor** e o nome/CNPJ da loja que recebe. parameters: - name: txid in: path required: true schema: type: string responses: '200': description: Dados da cobrança para exibição. content: application/json: schema: type: object properties: data: type: object properties: txid: type: string description: type: - string - 'null' amount: type: number format: double customer_name: type: - string - 'null' customer_document: type: - string - 'null' description: >- Documento mascarado no servidor. CPF: 390.***.447-**; CNPJ: 12.***.***/0001-**. pix_code: type: - string - 'null' description: Pix copia e cola qr_code_url: type: - string - 'null' status: type: string enum: - pending - paid - expired - canceled - refunded end_to_end_id: type: - string - 'null' expires_at: type: - string - 'null' format: date-time paid_at: type: - string - 'null' format: date-time created_at: type: string format: date-time store_name: type: - string - 'null' description: >- Nome do recebedor. Em cobrança paga é o congelado no momento do pagamento; antes de pagar, vem do cadastro atual do lojista. store_document: type: - string - 'null' description: >- CNPJ formatado do recebedor, congelado no pagamento (ver store_name). environment: type: string enum: - test - live description: >- `test` quando a cobrança nasceu em modo teste. O checkout mostra o aviso e o botão de simular pagamento. product_id: type: - string - 'null' description: >- Produto que originou a cobrança (modo produto); nulo em cobrança manual ou anterior ao campo. success_url: type: - string - 'null' description: >- Para onde mandar o pagador após pagar; nulo quando não configurada. cancel_url: type: - string - 'null' description: O "voltar" do checkout; nulo quando não configurada. '400': $ref: '#/components/responses/BadRequest' '404': $ref: '#/components/responses/NotFound' '429': description: >- Consultas demais deste endereço (mais de 300 em 10 minutos). O polling normal do checkout, a cada 5 s, fica bem abaixo disso; aguarde e tente de novo. content: application/json: schema: type: object properties: error: type: object properties: message: type: string components: responses: BadRequest: description: Erro de validação nos dados enviados. content: application/json: schema: $ref: '#/components/schemas/Error' NotFound: description: O recurso solicitado não foi encontrado. content: application/json: schema: $ref: '#/components/schemas/Error' schemas: Error: type: object properties: error: type: object properties: message: type: string description: Descrição da mensagem de erro. ````