> ## Documentation Index > Fetch the complete documentation index at: https://docs.korbit.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Contestar refund > Contesta a devolução com sua argumentação e evidências. A contestação segue para revisão da Korbit com o comprador. ## OpenAPI ````yaml /openapi/korbit-public-v1.json post /v1/refund-cases/{caseId}/merchant-contest openapi: 3.1.0 info: title: Korbit API version: 1.0.0 description: >- API de pagamentos da Korbit para merchants: PIX, cartão (com 3DS), assinaturas, checkout por link, payouts, antecipações e refunds — com idempotência, webhooks assinados e ambiente sandbox. contact: name: Suporte Korbit email: suporte@korbit.com.br servers: - url: https://api.korbit.com.br description: Produção (chaves kbt_live_) - url: https://api-test.korbit.com.br description: Sandbox (chaves kbt_test_) security: - bearerAuth: [] tags: - name: Antecipações - name: Assinaturas - name: Atividade - name: Catálogo - name: Chaves de API - name: Checkout - name: Clientes e Pedidos - name: Pagamentos - name: Refunds e Disputas - name: Saldo e Saques - name: Sandbox - name: Webhooks paths: /v1/refund-cases/{caseId}/merchant-contest: post: tags: - Refunds e Disputas summary: Contestar refund description: >- Contesta a devolução com sua argumentação e evidências. A contestação segue para revisão da Korbit com o comprador. operationId: contestCustomerRefundAsMerchant parameters: - schema: type: string format: uuid in: path name: caseId required: true - schema: type: string minLength: 1 maxLength: 255 in: header name: idempotency-key required: true requestBody: required: true content: application/json: schema: type: object additionalProperties: false required: - evidenceDescription - evidenceReference - reason properties: evidenceDescription: type: string minLength: 1 maxLength: 1000 evidenceReference: type: string minLength: 1 maxLength: 255 reason: type: string minLength: 1 maxLength: 1000 responses: '200': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - amount - approvalMode - blockedBy - currency - evidenceCount - id - initiator - invoiceId - merchantDecision - merchantReviewDeadlineAt - orderId - paymentIntentId - paymentPaidAt - provider - reason - refundWindow - requestedAt - status - updatedAt properties: amount: type: integer minimum: 1 maximum: 9007199254740991 approvalMode: anyOf: - type: string enum: - INSTANT - OPERATIONS - RISK_POLICY - type: 'null' blockedBy: type: array items: type: string enum: - INSUFFICIENT_AVAILABLE_BALANCE - KYC_NOT_APPROVED - MERCHANT_NOT_ACTIVE - PAYMENT_DISPUTED - PAYMENT_NOT_LIVE - REFUND_FREQUENCY_24H - REFUND_VOLUME_24H currency: type: string enum: - BRL evidenceCount: type: integer minimum: 0 id: type: string format: uuid initiator: type: string enum: - CUSTOMER - MERCHANT invoiceId: anyOf: - type: string format: uuid - type: 'null' merchantDecision: anyOf: - type: object additionalProperties: false required: - decidedAt - decision - reason properties: decidedAt: anyOf: - type: string format: date-time - type: 'null' decision: type: string enum: - APPROVED - CONTESTED - EXPIRED reason: anyOf: - type: string - type: 'null' - type: 'null' merchantReviewDeadlineAt: anyOf: - type: string format: date-time - type: 'null' orderId: anyOf: - type: string format: uuid - type: 'null' paymentIntentId: type: string format: uuid paymentPaidAt: anyOf: - type: string format: date-time - type: 'null' provider: anyOf: - type: object additionalProperties: false required: - refundId - submissionStatus - submittedAt properties: refundId: anyOf: - type: string - type: 'null' submissionStatus: anyOf: - type: string - type: 'null' submittedAt: anyOf: - type: string format: date-time - type: 'null' - type: 'null' reason: type: string refundWindow: anyOf: - type: object additionalProperties: false required: - days - expiresAt properties: days: type: integer minimum: 7 maximum: 90 expiresAt: type: string format: date-time - type: 'null' requestedAt: type: string format: date-time status: type: string enum: - MERCHANT_REVIEW - KORBIT_REVIEW - APPROVED_FOR_EXECUTION - FUNDING_REQUIRED - PROCESSING - SUCCEEDED - FAILED - CANCELED - REJECTED updatedAt: type: string format: date-time '201': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - amount - approvalMode - blockedBy - currency - evidenceCount - id - initiator - invoiceId - merchantDecision - merchantReviewDeadlineAt - orderId - paymentIntentId - paymentPaidAt - provider - reason - refundWindow - requestedAt - status - updatedAt properties: amount: type: integer minimum: 1 maximum: 9007199254740991 approvalMode: anyOf: - type: string enum: - INSTANT - OPERATIONS - RISK_POLICY - type: 'null' blockedBy: type: array items: type: string enum: - INSUFFICIENT_AVAILABLE_BALANCE - KYC_NOT_APPROVED - MERCHANT_NOT_ACTIVE - PAYMENT_DISPUTED - PAYMENT_NOT_LIVE - REFUND_FREQUENCY_24H - REFUND_VOLUME_24H currency: type: string enum: - BRL evidenceCount: type: integer minimum: 0 id: type: string format: uuid initiator: type: string enum: - CUSTOMER - MERCHANT invoiceId: anyOf: - type: string format: uuid - type: 'null' merchantDecision: anyOf: - type: object additionalProperties: false required: - decidedAt - decision - reason properties: decidedAt: anyOf: - type: string format: date-time - type: 'null' decision: type: string enum: - APPROVED - CONTESTED - EXPIRED reason: anyOf: - type: string - type: 'null' - type: 'null' merchantReviewDeadlineAt: anyOf: - type: string format: date-time - type: 'null' orderId: anyOf: - type: string format: uuid - type: 'null' paymentIntentId: type: string format: uuid paymentPaidAt: anyOf: - type: string format: date-time - type: 'null' provider: anyOf: - type: object additionalProperties: false required: - refundId - submissionStatus - submittedAt properties: refundId: anyOf: - type: string - type: 'null' submissionStatus: anyOf: - type: string - type: 'null' submittedAt: anyOf: - type: string format: date-time - type: 'null' - type: 'null' reason: type: string refundWindow: anyOf: - type: object additionalProperties: false required: - days - expiresAt properties: days: type: integer minimum: 7 maximum: 90 expiresAt: type: string format: date-time - type: 'null' requestedAt: type: string format: date-time status: type: string enum: - MERCHANT_REVIEW - KORBIT_REVIEW - APPROVED_FOR_EXECUTION - FUNDING_REQUIRED - PROCESSING - SUCCEEDED - FAILED - CANCELED - REJECTED updatedAt: type: string format: date-time '401': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - detail - instance - requestId - status - title - type properties: code: type: string detail: type: string instance: type: string requestId: type: string status: type: integer minimum: 400 maximum: 599 title: type: string type: type: string '403': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - detail - instance - requestId - status - title - type properties: code: type: string detail: type: string instance: type: string requestId: type: string status: type: integer minimum: 400 maximum: 599 title: type: string type: type: string '404': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - detail - instance - requestId - status - title - type properties: code: type: string detail: type: string instance: type: string requestId: type: string status: type: integer minimum: 400 maximum: 599 title: type: string type: type: string '409': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - detail - instance - requestId - status - title - type properties: code: type: string detail: type: string instance: type: string requestId: type: string status: type: integer minimum: 400 maximum: 599 title: type: string type: type: string '422': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - detail - instance - requestId - status - title - type properties: code: type: string detail: type: string instance: type: string requestId: type: string status: type: integer minimum: 400 maximum: 599 title: type: string type: type: string '503': description: Default Response content: application/json: schema: type: object additionalProperties: false required: - detail - instance - requestId - status - title - type properties: code: type: string detail: type: string instance: type: string requestId: type: string status: type: integer minimum: 400 maximum: 599 title: type: string type: type: string security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Korbit API key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.