dLocal · Capability

dLocal Payouts V3 API — Payouts

dLocal Payouts V3 capability — request, retrieve, release, and cancel payouts to beneficiaries in 60+ emerging-market countries. Uses OAuth2 bearer auth.

dLocal Payouts V3 API — Payouts is a Naftiko capability published by dLocal, one of 7 capabilities the APIs.io network indexes for this provider. It bundles 5 operations.

The capability includes 2 read-only operations and 3 state-changing operations. Lead operation: dLocal Request A Payout. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include dLocal, Payouts, and Disbursements.

Run with Naftiko dLocalPayoutsDisbursements

MCP Tools

dlocal-request-payout

dLocal Request A Payout

dlocal-get-payout

dLocal Get A Payout

read-only idempotent

dlocal-cancel-payout

dLocal Cancel A Payout

idempotent

dlocal-release-payout

dLocal Release A Payout

dlocal-get-payouts-balance

dLocal Get Payouts Balance

read-only idempotent

Capability Spec

naftiko: 1.0.0-alpha2
info:
  label: dLocal Payouts V3 API — Payouts
  description: dLocal Payouts V3 capability — request, retrieve, release, and cancel
    payouts to beneficiaries in 60+ emerging-market countries. Uses OAuth2 bearer auth.
  tags:
  - dLocal
  - Payouts
  - Disbursements
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys:
    DLOCAL_PAYOUTS_BEARER: DLOCAL_PAYOUTS_BEARER
capability:
  consumes:
  - type: http
    namespace: payouts-v3-payouts
    baseUri: https://api.dlocal.com
    description: dLocal Payouts V3 business capability.
    resources:
    - name: payouts
      path: /payouts/v3
      operations:
      - name: requestpayout
        method: POST
        description: dLocal Request A Payout
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: payout-by-id
      path: /payouts/v3/{payout_id}
      operations:
      - name: getpayout
        method: GET
        description: dLocal Get A Payout
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: payout_id
          in: path
          type: string
          required: true
      - name: cancelpayout
        method: POST
        path: /payouts/v3/{payout_id}/cancel
        description: dLocal Cancel A Payout
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: payout_id
          in: path
          type: string
          required: true
      - name: releasepayout
        method: POST
        path: /payouts/v3/{payout_id}/release
        description: dLocal Release A Payout
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: payout_id
          in: path
          type: string
          required: true
    - name: balance
      path: /payouts/v3/balance
      operations:
      - name: getbalance
        method: GET
        description: dLocal Get Payouts Balance
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      value: '{{env.DLOCAL_PAYOUTS_BEARER}}'
      placement: header
  exposes:
  - type: mcp
    namespace: payouts-v3-payouts-mcp
    port: 9090
    transport: http
    description: MCP adapter for dLocal Payouts V3.
    tools:
    - name: dlocal-request-payout
      description: dLocal Request A Payout
      hints: { readOnly: false, destructive: false, idempotent: false }
      call: payouts-v3-payouts.requestpayout
      with: { body: tools.body }
      outputParameters:
      - type: object
        mapping: $.
    - name: dlocal-get-payout
      description: dLocal Get A Payout
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: payouts-v3-payouts.getpayout
      with: { payout_id: tools.payout_id }
      outputParameters:
      - type: object
        mapping: $.
    - name: dlocal-cancel-payout
      description: dLocal Cancel A Payout
      hints: { readOnly: false, destructive: true, idempotent: true }
      call: payouts-v3-payouts.cancelpayout
      with: { payout_id: tools.payout_id }
      outputParameters:
      - type: object
        mapping: $.
    - name: dlocal-release-payout
      description: dLocal Release A Payout
      hints: { readOnly: false, destructive: false, idempotent: false }
      call: payouts-v3-payouts.releasepayout
      with: { payout_id: tools.payout_id }
      outputParameters:
      - type: object
        mapping: $.
    - name: dlocal-get-payouts-balance
      description: dLocal Get Payouts Balance
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: payouts-v3-payouts.getbalance
      outputParameters:
      - type: object
        mapping: $.