Stripe · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Stripe Accounts Account Sources API

8 actions 8 updates phrasing extends openapi/stripe-sources-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Stripe's API. It is a proposal applied on top of the contract, not a document Stripe publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 8

$.info
$.paths['/v1/sources'].post
$.paths['/v1/sources/{source}'].get
$.paths['/v1/sources/{source}'].post
$.paths['/v1/sources/{source}/mandate_notifications/{mandate_notification}'].get
$.paths['/v1/sources/{source}/source_transactions'].get
$.paths['/v1/sources/{source}/source_transactions/{source_transaction}'].get
$.paths['/v1/sources/{source}/verify'].post

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Stripe Accounts Account Sources API
  version: 1.0.0
extends: openapi/stripe-sources-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: 7
- target: $.paths['/v1/sources'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a payment source
      effect: write
      questions:
      - How do I create a payment source for a customer to pay with?
      - Can I create a single-use source for a fixed amount?
      - Which source types can I create?
      instructions:
      - text: Create a {type} source for {amount} in {currency}.
        slots:
          type: requestBody.type
          amount: requestBody.amount
          currency: requestBody.currency
      - text: Create a source from token {token}.
        slots:
          token: requestBody.token
      - text: Create a {type} source with usage {usage} for customer {customer}.
        slots:
          type: requestBody.type
          usage: requestBody.usage
          customer: requestBody.customer
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/sources/{source}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a payment source
      effect: read
      questions:
      - How do I check the current status of a payment source?
      - Can a client fetch a source using its client secret?
      instructions:
      - text: Get source {source}.
        slots:
          source: path.source
      - text: Fetch source {source} with client secret {client_secret}.
        slots:
          source: path.source
          client_secret: query.client_secret
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/sources/{source}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a payment source
      effect: write
      questions:
      - How do I change the owner details on a payment source?
      - Can I update the amount on a source after creating it?
      instructions:
      - text: Update the owner of source {source} to {owner}.
        slots:
          source: path.source
          owner: requestBody.owner
      - text: Change the amount on source {source} to {amount}.
        slots:
          source: path.source
          amount: requestBody.amount
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/sources/{source}/mandate_notifications/{mandate_notification}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a source mandate notification
      effect: read
      questions:
      - How do I look up a mandate notification sent for a source?
      - Where do I see what a debit mandate notification said?
      instructions:
      - text: Get mandate notification {mandate_notification} for source {source}.
        slots:
          mandate_notification: path.mandate_notification
          source: path.source
      - text: Show notification {mandate_notification} sent about source {source}'s mandate.
        slots:
          mandate_notification: path.mandate_notification
          source: path.source
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/sources/{source}/source_transactions'].get
  update:
    x-apievangelist-phrasing:
      intent: List transactions on a payment source
      effect: read
      questions:
      - How do I see the funds pushed to a source, like a credit transfer?
      - Can I list every transaction on one source?
      instructions:
      - text: List transactions for source {source}.
        slots:
          source: path.source
      - text: Show the last {limit} transactions on source {source}.
        slots:
          limit: query.limit
          source: path.source
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/sources/{source}/source_transactions/{source_transaction}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve one source transaction
      effect: read
      questions:
      - How do I look up a single transaction on a payment source?
      - Can I see the details of one transfer received by a source?
      instructions:
      - text: Get transaction {source_transaction} on source {source}.
        slots:
          source_transaction: path.source_transaction
          source: path.source
      - text: Show source transaction {source_transaction} for source {source}.
        slots:
          source_transaction: path.source_transaction
          source: path.source
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/sources/{source}/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a payment source
      effect: write
      questions:
      - How do I verify a payment source that needs confirmation values?
      - What do I send to complete verification of a source?
      instructions:
      - text: Verify source {source} with values {values}.
        slots:
          source: path.source
          values: requestBody.values
      - text: Submit verification values {values} for source {source}.
        slots:
          values: requestBody.values
          source: path.source
      method: generated
      generated: '2026-09-26'