name: recurring-subscription
description: |
  Workflow capability: onboard a buyer onto a recurring Mercado Pago
  subscription. Agent creates a preapproval (optionally bound to a shared
  plan), redirects the buyer to authorise, then listens for
  subscription_authorized_payment and subscription_preapproval webhooks.
provider: mercado-pago
shared:
  - shared/subscriptions.yaml
flow:
  - step: Create or reuse plan
    operationId: createPlan
    optional: true
  - step: Create subscription
    operationId: createSubscription
    input:
      reason: required
      payer_email: required
      auto_recurring.frequency: required
      auto_recurring.frequency_type: required
      auto_recurring.transaction_amount: required
      auto_recurring.currency_id: required
      back_url: required
    output:
      init_point: redirect_url_for_buyer
  - step: Listen for activation
    triggers:
      - webhook: subscription_preapproval.updated
  - step: Listen for recurring charges
    triggers:
      - webhook: subscription_authorized_payment.created
tags:
  - Subscriptions
  - Recurring
  - Workflow