Quickstart

Five-minute integration. You send the agent's intended action to the gateway, ifivo returns a deterministic decision, and your code executes (or doesn't) accordingly.

1. Create an agent

Sign in, go to Agents → New, and copy the key starting with sk_live_. Keys are scoped to one agent and can be rotated at any time.

2. Send a request

curl -X POST https://www.ifivo.com/api/gateway/actions \
  -H "content-type: application/json" \
  -d '{
    "agent_api_key": "sk_live_…",
    "vendor": "stripe",
    "action": "refund",
    "amount_cents": 22000,
    "risk_score": 0.55,
    "metadata": { "order_id": "ord_123", "reason": "duplicate charge" }
  }'

3. Read the decision

Every response contains a decision.outcome of allowed, pending_approval, or blocked. In shadow mode, the live outcome is always allowed and what the policy would have done is returned under shadow.

{
  "decision": {
    "outcome": "pending_approval",
    "reason": "Refunds over $150 require approval",
    "policy": "refunds-over-150",
    "shadow": null
  },
  "transaction_id": "tx_01JABC…"
}

4. Next steps

• Write your first policy — start with one of the templates.
• Wire up Slack approvals — signed one-click approve/deny links.
• Test edge cases — the public simulator runs the same engine.