openapi: 3.1.0
info:
  title: RenkoPay Acquiring API
  version: 1.0.0
  description: API pública do RenkoPay Adquirência. Valores monetários são inteiros em centavos.
servers:
  - url: https://acquiring.renkopay.com.br/api/v1
paths:
  /auth/token:
    post:
      summary: Emite bearer token por client_id/client_secret
      responses:
        '200':
          description: Token emitido
  /transactions:
    get:
      security: [{ bearerAuth: [] }]
      summary: Lista transações do tenant/merchant autenticado
      responses:
        '200': { description: OK }
  /terminals:
    get:
      security: [{ bearerAuth: [] }]
      summary: Lista terminais POS
      responses:
        '200': { description: OK }
  /ecommerce/transactions:
    post:
      security: [{ bearerAuth: [] }]
      summary: Cria transação e-commerce
      parameters:
        - in: header
          name: Idempotency-Key
          required: true
          schema: { type: string }
      responses:
        '200': { description: Transação criada/processada }
        '422': { description: Payload inválido }
  /receivables:
    get:
      security: [{ bearerAuth: [] }]
      summary: Lista recebíveis
      responses:
        '200': { description: OK }
  /settlements:
    get:
      security: [{ bearerAuth: [] }]
      summary: Lista liquidações
      responses:
        '200': { description: OK }
  /reconciliations:
    get:
      security: [{ bearerAuth: [] }]
      summary: Lista itens de conciliação
      responses:
        '200': { description: OK }
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
