Vybevybe

Collect · OpenAPI

Merchant & agent HTTP spec

Public subset for integrators — catalog, 402 pay, invoke proxy, checkout sessions, and Collect business API. For step-by-step setup, use the integration guide.

Download YAMLIntegration guide

Spec URL

Import this URL into Postman, Insomnia, or your IDE OpenAPI extension:

https://www.vybe.finance/collect/openapi.yaml

Included routes

  • GET /api/agent/collect/{username} — agent catalog
  • GET|POST …/{offeringId} — HTTP 402 pay intent
  • …/status — poll or settle with tx hash
  • /api/agent/invoke/… — pay-then-call proxy (API/MCP)
  • POST /api/checkout/sessions — Native Checkout
  • /api/collect/v1/* — keys, offerings, webhooks

Webhooks

Events: payment.paid, payment.expired, and webhook.test (integration health ping from Business desk). Verify X-Vybe-Signature. Checkout session metadata is echoed on paid/expired events when set at create time.

Integration guide · Checkout overview