API Evangelist conversational phrasing for Token.io's Open Banking API for TPPs Payments v2 API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Token.io's Open Banking API for TPPs Payments v2 API
  version: 1.0.0
extends: openapi/token-io-payments-v2-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: 5
- target: $.paths['/v2/payments'].get
  update:
    x-apievangelist-phrasing:
      intent: List payments with filters
      effect: read
      questions:
      - Which of my payments were refunded or partially refunded?
      - Can I filter payments by status and creation date?
      - Is there a required page size when listing payments?
      instructions:
      - text: List {limit} payments with statuses {statuses}.
        slots:
          limit: query.limit
          statuses: query.statuses
      - text: Show {limit} payments created after {created_after}.
        slots:
          limit: query.limit
          created_after: query.createdAfter
      - text: List {limit} payments with refund statuses {refund_statuses}.
        slots:
          limit: query.limit
          refund_statuses: query.refundStatuses
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/payments'].post
  update:
    x-apievangelist-phrasing:
      intent: Initiate a payment with a bank
      effect: write
      questions:
      - How do I kick off a pay-by-bank payment for a customer?
      - What happens after I initiate a payment, does the user authenticate with their bank?
      instructions:
      - text: Initiate a payment with initiation {initiation}.
        slots:
          initiation: requestBody.initiation
      - text: Start payment {initiation} and accept the PIS consent {accepted}.
        slots:
          initiation: requestBody.initiation
          accepted: requestBody.pispConsentAccepted
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/payments/{paymentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a payment and check its next step
      effect: read
      questions:
      - What's the status of one payment and what should happen next?
      - Can I look up a single payment by id?
      instructions:
      - text: Get payment {payment_id}.
        slots:
          payment_id: path.paymentId
      - text: Check the status and next step of payment {payment_id}.
        slots:
          payment_id: path.paymentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/payments/{paymentId}/embedded-auth'].post
  update:
    x-apievangelist-phrasing:
      intent: Provide embedded authentication fields for a payment
      effect: write
      questions:
      - A payment is in INITIATION_PENDING_EMBEDDED_AUTH; what do I send?
      - Can I supply the bank's requested fields without redirecting the user?
      instructions:
      - text: Provide embedded auth {embedded_auth} for payment {payment_id}.
        slots:
          embedded_auth: requestBody.embeddedAuth
          payment_id: path.paymentId
      - text: Submit the requested embedded authentication fields for payment {payment_id}.
        slots:
          payment_id: path.paymentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/qr-code'].get
  update:
    x-apievangelist-phrasing:
      intent: Generate a QR code for data
      effect: read
      questions:
      - Can I generate a scannable QR code for a payment URL?
      - What format and size is the generated QR code?
      instructions:
      - text: Generate a QR code for {data}.
        slots:
          data: query.data
      - text: Make an SVG QR code encoding {data}.
        slots:
          data: query.data
      method: generated
      generated: '2026-09-26'