Square Sale to Twilio SMS Confirmation

arazzo: 1.0.1
info:
  title: Square Sale to Twilio SMS Confirmation
  summary: Take a Square payment with Block, then text the buyer via Twilio.
  description: >-
    A cross-provider workflow that captures a sale through Block's Square Payments
    API and, on a completed payment, sends the buyer an SMS confirmation through
    Twilio's Messaging API. Ideal for mobile checkout and counter sales where a text
    receipt is faster than email.
  version: 1.0.0
sourceDescriptions:
  - name: blockApi
    url: https://raw.githubusercontent.com/api-evangelist/block/refs/heads/main/openapi/block-payments-api-openapi.yml
    type: openapi
  - name: twilioApi
    url: https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/openapi/twilio-messages-api-openapi.yml
    type: openapi
workflows:
  - workflowId: square-sale-sms
    summary: Create a Square payment, then SMS a Twilio confirmation.
    description: >-
      Creates a payment with Block's Square Payments API and, on a completed sale,
      texts the buyer a confirmation via Twilio Messaging.
    inputs:
      type: object
      properties:
        sourceId:
          type: string
        idempotencyKey:
          type: string
        amount:
          type: integer
        currency:
          type: string
        accountSid:
          type: string
        fromNumber:
          type: string
        toNumber:
          type: string
    steps:
      - stepId: create-payment
        description: Create a payment with Block's Square Payments API.
        operationId: $sourceDescriptions.blockApi.create-payment
        requestBody:
          contentType: application/json
          payload:
            source_id: $inputs.sourceId
            idempotency_key: $inputs.idempotencyKey
            amount_money:
              amount: $inputs.amount
              currency: $inputs.currency
        successCriteria:
          - condition: $statusCode == 200
          - condition: $response.body#/payment/status == "COMPLETED"
        outputs:
          paymentId: $response.body#/payment/id
          paymentStatus: $response.body#/payment/status
      - stepId: sms-confirmation
        description: Text the buyer a confirmation 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: Your Square payment $steps.create-payment.outputs.paymentId is complete.
        successCriteria:
          - condition: $statusCode == 201
        outputs:
          messageSid: $response.body#/sid
          messageStatus: $response.body#/status
    outputs:
      paymentId: $steps.create-payment.outputs.paymentId
      paymentStatus: $steps.create-payment.outputs.paymentStatus
      messageSid: $steps.sms-confirmation.outputs.messageSid