name: accept-pix-payment
description: |
  Workflow capability: accept a Brazilian PIX payment end-to-end. Agent
  creates a /v1/payments resource with payment_method_id=pix, returns the
  QR code + ticket URL to the buyer, polls payment status (or relies on
  signed webhook delivery), then optionally issues a refund.
provider: mercado-pago
shared:
  - shared/payments.yaml
flow:
  - step: Create PIX payment
    operationId: createPayment
    input:
      payment_method_id: pix
      transaction_amount: required
      payer.email: required
      external_reference: recommended
    output:
      qr_code: point_of_interaction.transaction_data.qr_code
      qr_code_base64: point_of_interaction.transaction_data.qr_code_base64
      ticket_url: point_of_interaction.transaction_data.ticket_url
  - step: Verify payment status
    operationId: getPayment
    triggers:
      - webhook: payment.updated
      - poll: 5s_until_terminal
  - step: Refund if needed
    operationId: refundPayment
    optional: true
tags:
  - PIX
  - Brazil
  - Workflow
  - Payments