Stripe Payout to SendGrid Statement and Slack Notify

arazzo: 1.0.1
info:
  title: Stripe Payout to SendGrid Statement and Slack Notify
  summary: Create a Stripe payout, email a statement, then notify Slack ops.
  description: >-
    A three-provider finance workflow that initiates a payout through Stripe's
    Payouts API, emails an accounting contact a payout statement via SendGrid's Mail
    Send API, and posts a confirmation into a Slack channel. Gives finance both a
    durable email record and a real-time team notification for every payout.
  version: 1.0.0
sourceDescriptions:
  - name: stripeApi
    url: https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/openapi/stripe-payouts-api-openapi.yml
    type: openapi
  - name: sendgridApi
    url: https://raw.githubusercontent.com/api-evangelist/sendgrid/refs/heads/main/openapi/sendgrid-mail-send-api-openapi.yml
    type: openapi
  - name: slackApi
    url: https://raw.githubusercontent.com/api-evangelist/slack/refs/heads/main/openapi/slack-chat-api-openapi.yml
    type: openapi
workflows:
  - workflowId: payout-statement-and-notify
    summary: Create a Stripe payout, email a SendGrid statement, notify Slack.
    description: >-
      Creates a payout in Stripe, emails an accounting contact a statement via
      SendGrid, and posts a Slack notification.
    inputs:
      type: object
      properties:
        amount:
          type: integer
        currency:
          type: string
        accountingEmail:
          type: string
        channel:
          type: string
    steps:
      - stepId: create-payout
        description: Initiate a payout from the Stripe balance.
        operationId: $sourceDescriptions.stripeApi.postPayouts
        requestBody:
          contentType: application/x-www-form-urlencoded
          payload:
            amount: $inputs.amount
            currency: $inputs.currency
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          payoutId: $response.body#/id
          payoutAmount: $response.body#/amount
      - stepId: email-statement
        description: Email the accounting contact a payout statement via SendGrid.
        operationId: $sourceDescriptions.sendgridApi.SendMail
        requestBody:
          contentType: application/json
          payload:
            personalizations:
              - to:
                  - email: $inputs.accountingEmail
                subject: Payout statement
            from:
              email: finance@example.com
            content:
              - type: text/plain
                value: Payout $steps.create-payout.outputs.payoutId for $steps.create-payout.outputs.payoutAmount has been initiated.
        successCriteria:
          - condition: $statusCode == 202
        outputs:
          emailStatus: $statusCode
      - stepId: slack-notify
        description: Post a payout confirmation into a Slack channel.
        operationId: $sourceDescriptions.slackApi.postChatPostmessage
        requestBody:
          contentType: application/json
          payload:
            channel: $inputs.channel
            text: Payout $steps.create-payout.outputs.payoutId initiated and statement emailed.
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          posted: $response.body#/ok
    outputs:
      payoutId: $steps.create-payout.outputs.payoutId
      emailStatus: $steps.email-statement.outputs.emailStatus
      slackPosted: $steps.slack-notify.outputs.posted