Lean Technologies

Lean Refunds API

Issue full or partial refunds against prior Pay by Bank payments. List refunds, create a new refund, process queued refunds, and retrieve the canonical list of refund reason codes.

Lean Refunds API is one of 11 APIs that Lean Technologies publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 machine-runnable capability that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko.

Tagged areas include Open Banking, Refunds, and Payouts. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, and 1 Naftiko capability spec.

GitHub OpenAPI

Documentation

📖
Documentation
https://docs.leantech.me/reference/refunds

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/lean-tech/refs/heads/main/openapi/lean-refunds-api-openapi.yml

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/lean-tech/refs/heads/main/capabilities/refunds-refunds.yaml

OpenAPI Specification

lean-refunds-api-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Lean Refunds API
  description: >
    Issue full or partial refunds against prior Pay by Bank payments. List
    refunds, create a refund, process queued refunds, and retrieve the
    canonical list of refund reason codes.
  version: '1.0'
  contact:
    name: Lean Support
    url: https://help.leantech.me
servers:
  - url: https://api2.leantech.me
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Refunds
paths:
  /payouts/refunds:
    get:
      summary: Lean List Refunds
      operationId: listRefunds
      tags: [Refunds]
      responses:
        '200':
          description: Refunds
    post:
      summary: Lean Create Refund
      operationId: createRefund
      tags: [Refunds]
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefundRequest'
      responses:
        '201':
          description: Refund created
    put:
      summary: Lean Process Refunds
      operationId: processRefunds
      tags: [Refunds]
      responses:
        '200':
          description: Refunds processed
  /payouts/refunds/reasons:
    get:
      summary: Lean Get Refund Reasons
      operationId: getRefundReasons
      tags: [Refunds]
      responses:
        '200':
          description: Refund reasons
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    code:
                      type: string
                    description:
                      type: string
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
  schemas:
    RefundRequest:
      type: object
      required: [payment_id, amount, reason_code]
      properties:
        payment_id:
          type: string
          format: uuid
        amount:
          type: number
        currency:
          type: string
        reason_code:
          type: string
        description:
          type: string
        idempotency_key:
          type: string