naftiko: 1.0.0-alpha2
info:
  label: dLocal Emerging-Markets Payments Workflow
  description: Workflow-oriented composition of dLocal capabilities for accepting,
    refunding, and disbursing payments in LatAm, Africa, and Asia. Composes
    Payments, Refunds, Cards, Payouts V3, and KYC Verifications.
  tags:
  - dLocal
  - Workflow
  - EmergingMarkets
  - LatAm
  - Africa
  - Asia
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys:
    DLOCAL_LOGIN: DLOCAL_LOGIN
    DLOCAL_TRANS_KEY: DLOCAL_TRANS_KEY
    DLOCAL_SECRET: DLOCAL_SECRET
    DLOCAL_PAYOUTS_BEARER: DLOCAL_PAYOUTS_BEARER
imports:
- capability: ./payments-payments.yaml
  as: payments
- capability: ./refunds-refunds.yaml
  as: refunds
- capability: ./cards-cards.yaml
  as: cards
- capability: ./payouts-v3-payouts.yaml
  as: payouts
- capability: ./kyc-verifications.yaml
  as: kyc
workflows:
- name: accept-payment-and-tokenize
  description: Tokenize a card with the Cards API, then immediately create a payment using the token.
  steps:
  - call: cards.createcard
  - call: payments.createpayment
- name: refund-payment
  description: Look up a payment status and create a (full or partial) refund.
  steps:
  - call: payments.retrievepaymentstatus
  - call: refunds.makerefund
- name: kyc-then-payout
  description: Verify a beneficiary via KYC then disburse via Payouts V3.
  steps:
  - call: kyc.createverification
  - call: payouts.requestpayout