Stripe Dispute to Twilio SMS and Slack Alert

arazzo: 1.0.1
info:
  title: Stripe Dispute to Twilio SMS and Slack Alert
  summary: Submit a Stripe dispute, SMS the on-call, then alert the Slack risk channel.
  description: >-
    A three-provider incident workflow that submits evidence on a Stripe dispute,
    pages the on-call analyst by SMS through Twilio's Messaging API, and posts a
    detailed alert into a Slack risk channel. Ensures a chargeback dispute reaches
    both the responsible person and the team record simultaneously.
  version: 1.0.0
sourceDescriptions:
  - name: stripeApi
    url: https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/openapi/stripe-disputes-api-openapi.yml
    type: openapi
  - name: twilioApi
    url: https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/openapi/twilio-messaging-openapi.yml
    type: openapi
  - name: slackApi
    url: https://raw.githubusercontent.com/api-evangelist/slack/refs/heads/main/openapi/slack-chat-openapi.yml
    type: openapi
workflows:
  - workflowId: dispute-page-and-alert
    summary: Update a Stripe dispute, SMS the on-call, then post a Slack alert.
    description: >-
      Submits evidence on a Stripe dispute, texts the on-call analyst via Twilio, and
      posts a risk alert into a Slack channel.
    inputs:
      type: object
      properties:
        disputeId:
          type: string
        productDescription:
          type: string
        accountSid:
          type: string
        fromNumber:
          type: string
        toNumber:
          type: string
        channel:
          type: string
    steps:
      - stepId: update-dispute
        description: Submit evidence on the Stripe dispute.
        operationId: $sourceDescriptions.stripeApi.postDisputesDispute
        requestBody:
          contentType: application/x-www-form-urlencoded
          payload:
            dispute: $inputs.disputeId
            evidence[product_description]: $inputs.productDescription
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          disputeStatus: $response.body#/status
          disputeReason: $response.body#/reason
      - stepId: page-oncall
        description: Text the on-call analyst via Twilio Messaging.
        operationId: $sourceDescriptions.twilioApi.createMessage
        requestBody:
          contentType: application/x-www-form-urlencoded
          payload:
            AccountSid: $inputs.accountSid
            From: $inputs.fromNumber
            To: $inputs.toNumber
            Body: Dispute $inputs.disputeId needs review. Status $steps.update-dispute.outputs.disputeStatus.
        successCriteria:
          - condition: $statusCode == 201
        outputs:
          messageSid: $response.body#/sid
      - stepId: slack-alert
        description: Post a dispute alert into a Slack risk channel.
        operationId: $sourceDescriptions.slackApi.postChatPostmessage
        requestBody:
          contentType: application/json
          payload:
            channel: $inputs.channel
            text: Dispute $inputs.disputeId reason $steps.update-dispute.outputs.disputeReason is under review.
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          posted: $response.body#/ok
    outputs:
      disputeStatus: $steps.update-dispute.outputs.disputeStatus
      messageSid: $steps.page-oncall.outputs.messageSid
      slackPosted: $steps.slack-alert.outputs.posted