# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adyen Checkout Donations API
  version: 1.0.0
extends: openapi/adyen-donations-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 1
- target: $.paths['/donations'].post
  update:
    x-apievangelist-phrasing:
      intent: Make a donation after a payment
      effect: write
      questions:
      - Can a shopper donate to a charity right after paying?
      - What donation token do I use to start a donation?
      instructions:
      - text: Donate {amount} with token {token} for merchant {merchant}, ref {ref}, method {method}, return {url}.
        slots:
          amount: requestBody.amount
          token: requestBody.donationToken
          merchant: requestBody.merchantAccount
          ref: requestBody.reference
          method: requestBody.paymentMethod
          url: requestBody.returnUrl
      - text: Start a {amount} donation to {account} on {merchant} via {method}, ref {ref}, returning to {url}.
        slots:
          amount: requestBody.amount
          account: requestBody.donationAccount
          merchant: requestBody.merchantAccount
          method: requestBody.paymentMethod
          ref: requestBody.reference
          url: requestBody.returnUrl
      method: generated
      generated: '2026-09-26'