Integration · Your own service

Any agent that can answer a POST.

One small contract: COLVO sends the customer, context and conversation; your agent answers with JSON and proposes actions back with a per-test key.

Get early access Read the guide

Your agent

Your own serviceconnected

≠COLVOproposes · decides

TestGuard

Provider

Simulated Stripesandbox

Stripe liverestricted key

AvailableWorks today

How it works

Set it up in minutes

Expose a POST endpoint over public HTTPS that accepts COLVO’s JSON.
Answer with { "reply": "…" } — or any shape, with a reply path like data.answer.
Propose instead of acting. When the agent wants to refund or cancel, it POSTs to colvo.operations_url with colvo.agent_key.
Test connection shows the exact request and response; save the build and run the suite.

Propose an action

POST {colvo.operations_url}
Authorization: Bearer {colvo.agent_key}
Idempotency-Key: {colvo.source_request_id}:refund
Content-Type: application/json

{ "mandate_id": "{colvo.mandate_id}",
  "source_request_id": "{colvo.source_request_id}",
  "action": "refund.create",
  "parameters": { "payment_id": "pi_01", "amount_minor": 5000, "currency": "eur" } }

The agent never holds your payment keys — it proposes, COLVO decides and executes.

What you get

Your own service + COLVO

Any language

Node, Python, Go — and our SDKs for Node and Python do the propose call for you.

Any JSON shape

Set a reply path or let COLVO auto-detect common shapes.

Same contract in production

In Guard your backend builds the same request with a real mandate.

Questions

Your own service FAQ

Can I call it from localhost?

No — COLVO only calls public HTTPS hosts; private and metadata addresses are blocked. Use a tunnel for local testing.

Timeouts?

30 seconds per call; aim for a few seconds.

Reference: Connect your agent · Guard API

≠

Stop trusting the reply.

Test your agent before it ships — and guard every real action once it’s live. In a safe copy of your world first.

Book a demo Request early access