Developers

Built for autonomous systems. Designed for developers.

One authorization call sits between an agent's intent and a completed payment. Everything else — identity, mandates, policy, audit — is handled by PayHero.

API surface

Endpoints an agent runtime needs.

  • POST/v1/agentsCreate an agent identity bound to an organization.
  • POST/v1/mandatesPublish machine-readable financial authority.
  • POST/v1/transactions/authorizeEvaluate a proposed transaction in real time.
  • POST/v1/approvals/:id/decideResolve an escalated transaction.
  • GET/v1/audit/:transaction_idRetrieve the full decision record.
MandatePOST/v1/mandates
{
  "agent_id": "agt_2841",
  "monthly_max": 25000,
  "per_transaction_max": 2500,
  "categories": ["software", "cloud"],
  "regions": ["EU", "US"],
  "approval_threshold": 5000
}
Webhooktransaction.escalated
{
  "transaction_id": "txn_91043",
  "agent_id": "agt_2841",
  "amount": 7800,
  "reason": "above_autonomous_threshold",
  "approval_required": true
}

Developers

Built for autonomous systems. Designed for developers.

Integrate PayHero into agents, applications, marketplaces, and enterprise AI systems through developer-friendly APIs and agent-native protocols.
  • REST API
  • SDKs
  • Webhooks
  • MCP compatibility
  • Real-time authorization
  • Sandbox
  • Policy engine
  • Audit API
RequestPOST/v1/transactions/authorize
{
  "agent_id": "agt_2841",
  "merchant": "figma",
  "amount": 144,
  "currency": "EUR",
  "category": "software"
}
Response200 OK
{
  "decision": "authorized",
  "mandate": "mandate_9024",
  "approval_required": false
}

Flow

From agent intent to authorized payment.

Eight stages connect an autonomous decision to a governed, auditable transaction.
  1. 01

    Agent initiates action

    An AI agent determines that a purchase or payment is required.

  2. 02

    Identity verified

    PayHero identifies the agent and the organization it represents.

  3. 03

    Mandate retrieved

    The agent's delegated financial authority is loaded.

  4. 04

    Policy evaluated

    The proposed transaction is evaluated against relevant rules.

  5. 05

    Approval determined

    PayHero determines whether the transaction can proceed autonomously or requires human approval.

  6. 06

    Payment authorized

    The appropriate payment credential or payment rail is enabled.

  7. 07

    Transaction executes

    The merchant receives payment.

  8. 08

    Audit record created

    The complete decision and transaction history is recorded.

Hero, the PayHero agent, dashing forward with a payment briefcase

Get started

Prepare your business for autonomous commerce.

Give AI agents the financial authority they need — with the controls your organization requires.