Módulo Pay

Pay · Pagos de servicios

Pagá servicios con API real: AFIP, ARBA, IIBB, utilities, suscripciones. Sin browser automation, sin scraping — todo vía APIs oficiales o aggregators regulados.

Estado: Roadmap Q4 2026

El módulo Pay entra con las integraciones directas a AFIP, ARBA e Interbanking. La API definitiva puede ajustar shapes menores. La documentación de abajo es la interfaz planificada.

Overview

Pay resuelve el problema de "tu agente paga tu factura" sin recurrir a browser automation. Cada rail de servicio tiene su driver:

rails

AFIP           →  WS AFIP + certificado digital (VEP, monotributo, RG)
ARBA           →  WS ARBA por CUIT/CUIL
IIBB provinc.  →  WS específico según provincia
Edenor         →  Aggregator Pagos360
Metrogas       →  Aggregator Pagos360
Telecom        →  Aggregator Pagos360
Netflix/etc    →  Stripe subscription re-billing endpoint

GET /v1/pay/services

Lista los servicios disponibles para el país del cardholder.

curl

curl -X GET https://api.argentive.ai/v1/pay/services \
  -H "Authorization: Bearer sk_test_..."

response

{
  "services": [
    { "code": "afip",     "label": "AFIP",     "concepts": ["monotributo","autonomos","ganancias","iva"] },
    { "code": "arba",     "label": "ARBA",     "concepts": ["inmobiliario","automotor"] },
    { "code": "edenor",   "label": "Edenor",   "concepts": ["factura_mensual"] },
    { "code": "netflix",  "label": "Netflix",  "concepts": ["subscription"] }
  ]
}

POST /v1/pay/payments

Crea una solicitud de pago de servicio.

curl

curl -X POST https://api.argentive.ai/v1/pay/payments \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: agent-afip-2026-07" \
  -d '{
    "service":  "afip",
    "concept":  "monotributo",
    "period":   "2026-07",
    "identifier": {
      "type":  "cuit",
      "value": "20XXXXXXXX"
    },
    "amount":   26485,
    "currency": "ARS"
  }'

Response 202 (approval pending)

response

{
  "id":             "pay_01HW3F...",
  "status":         "pending_approval",
  "service":        "afip",
  "concept":        "monotributo",
  "period":         "2026-07",
  "amount":         26485,
  "currency":       "ARS",
  "approval":       { "channel": "whatsapp", "sent_at": "..." },
  "estimated_vep":  "01234567890123",
  "expires_at":     "2026-07-01T12:19:33Z"
}

GET /v1/pay/payments/:id

response

{
  "id":            "pay_01HW3F...",
  "status":        "settled",
  "service":       "afip",
  "concept":       "monotributo",
  "period":        "2026-07",
  "amount":        26485,
  "currency":      "ARS",
  "vep":           "01234567890123",
  "settled_at":    "2026-07-01T12:04:38Z",
  "receipt_url":   "https://argentive.ai/receipts/pay_01HW3F...",
  "external_receipt": {
    "provider":    "afip",
    "reference":   "F1256-2026-07-XXXXX",
    "downloadable_url": "https://api.argentive.ai/v1/pay/payments/pay_01HW3F.../receipt.pdf"
  }
}

POST /v1/pay/scheduled

Programa un pago recurrente (típicamente para servicios que vencen mensualmente). Tu agente puede confiar en que "el 5 de cada mes" el pago se hace solo.

curl

curl -X POST https://api.argentive.ai/v1/pay/scheduled \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "service":     "afip",
    "concept":     "monotributo",
    "identifier":  { "type": "cuit", "value": "20XXXXXXXX" },
    "schedule": {
      "cron":      "0 10 5 * *",
      "timezone":  "America/Argentina/Buenos_Aires"
    },
    "max_amount":  30000,
    "auto_approve_under": 30000
  }'

Errores comunes

errores

400  invalid_period               Formato de período inválido para el servicio
404  taxpayer_not_found           CUIT/CUIL no encontrado en AFIP
409  duplicate_payment            Ese VEP/period ya fue pagado
422  service_unavailable          El WS del servicio está caído (ej. AFIP)
502  external_service_error       Error del proveedor upstream (Pagos360, AFIP)

Webhooks

pay.approval_requested
pay.settled
pay.receipt_ready — comprobante formal disponible
pay.scheduled_created / pay.scheduled_executed