> ## Documentation Index > Fetch the complete documentation index at: https://docs.kiwify.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Ver Reembolso > Obtém detalhes de um reembolso PIX específico pelo seu ID. ## OpenAPI ````yaml /api-reference/banking/openapi.pt.json get /v1/refunds/{id} openapi: 3.1.0 info: title: API Conta Digital description: API pública para gerenciamento de conta, extrato e operações PIX license: name: '' version: 0.1.0 servers: - url: https://conta-public-api.kiwify.com description: Production environment security: [] tags: - name: Conta description: Detalhes da conta, saldo, limites e chaves PIX - name: Extrato description: Extrato e histórico de transações - name: Enviar Pix description: Enviar dinheiro via transferências PIX - name: Receber Pix description: Reembolsar transações PIX - name: Pagar boletos description: Pagar boletos via API - name: QR Codes PIX description: Geração de QR codes PIX para receber pagamentos - name: Webhooks description: >- Gerenciamento de assinaturas de webhook para recebimento de notificações de eventos paths: /v1/refunds/{id}: get: tags: - Receber Pix summary: Ver Reembolso description: Obtém detalhes de um reembolso PIX específico pelo seu ID. operationId: get_refund_by_id parameters: - name: id in: path description: Refund identifier required: true schema: type: integer format: int64 responses: '200': description: Refund retrieved successfully content: application/json: schema: $ref: '#/components/schemas/RefundItemResponse' '401': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Access denied - requires ViewTransactions permission content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: 'Refund not found. Error code: PAYMENT_NOT_FOUND' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - AccessId: [] PoPChallenge: [] PoPFormat: [] PoPSignature: [] components: schemas: RefundItemResponse: type: object required: - id - transaction_id - status - details - created_at - updated_at properties: beneficiary: oneOf: - type: 'null' - $ref: '#/components/schemas/BeneficiaryResponse' description: Beneficiary information (payer of original transfer) cancelled_at: type: - string - 'null' format: date-time description: Cancellation timestamp (UTC, RFC 3339), if cancelled. example: '2026-05-28T14:30:00Z' created_at: type: string format: date-time description: Refund creation timestamp (UTC, RFC 3339). example: '2026-05-28T14:30:00Z' details: $ref: '#/components/schemas/RefundDetailsResponse' description: Refund details (amount, message) external_reference_id: type: - string - 'null' description: External reference identifier provided by the client failed_message: type: - string - 'null' description: Error message if the refund failed id: type: integer format: int64 description: Refund identifier status: $ref: '#/components/schemas/RefundItemStatusResponse' description: Current status of the refund transaction_id: type: integer format: int64 description: Original transaction identifier updated_at: type: string format: date-time description: Last update timestamp (UTC, RFC 3339). example: '2026-05-28T14:30:00Z' ErrorResponse: type: object required: - error - timestamp properties: error: $ref: '#/components/schemas/ErrorDetails' description: Error payload. timestamp: type: string format: date-time description: ISO 8601 / RFC 3339 UTC timestamp of when the error occurred. example: '2026-05-28T14:30:00Z' BeneficiaryResponse: allOf: - $ref: '#/components/schemas/DestinationData' - $ref: '#/components/schemas/ResolvedData' - type: object properties: name: type: - string - 'null' tax_id: type: - string - 'null' RefundDetailsResponse: type: object required: - amount_in_cents properties: amount_in_cents: type: integer format: int64 description: Refund amount in cents message_to_payer: type: - string - 'null' description: Optional message to the payer RefundItemStatusResponse: type: string enum: - pending - processing - success - cancelled - failed ErrorDetails: type: object required: - code - message properties: code: type: string description: >- Machine-readable error code. Use this for branching logic, not `message`. example: INVALID_REQUEST details: type: object description: >- Optional structured details. For `INVALID_REQUEST`, may be an array of field validation errors or a `validation_failed` object depending on the endpoint. message: type: string description: >- Human-readable error description. Do not rely on this text for programmatic handling. DestinationData: oneOf: - type: object required: - pix_key properties: pix_key: type: string title: Chave Pix - type: object required: - ispb - branch_code - account_number properties: account_number: type: string account_type: oneOf: - type: 'null' - $ref: '#/components/schemas/PublicAccountType' branch_code: type: string ispb: type: string title: Transferência manual ResolvedData: type: object properties: resolved_account_number: type: - string - 'null' resolved_account_type: oneOf: - type: 'null' - $ref: '#/components/schemas/PublicAccountType' resolved_branch: type: - string - 'null' resolved_ispb: type: - string - 'null' PublicAccountType: type: string description: >- Account types allowed in the Public API. checking_account, savings_account, payment_account, and other_account are supported. enum: - checking_account - savings_account - payment_account - other_account securitySchemes: AccessId: type: apiKey in: header name: x-access-id description: UUID of the service account (e.g., 550e8400-e29b-41d4-a716-446655440000) PoPChallenge: type: apiKey in: header name: X-PoP-Challenge description: >- Unix timestamp in milliseconds (e.g., 1704636800000). Must be within 5 minutes of server time. PoPFormat: type: apiKey in: header name: X-PoP-Format description: Must be 'service-account' for service account authentication PoPSignature: type: apiKey in: header name: X-PoP-Signature description: >- EdDSA signature of the request in base64 format. Signs: uri:method:body:timestamp ````