First call

Get from API key to first order flow without guessing the contract.

The public builder path should be obvious before login. Start with the branded API base, authenticate with an API key, then validate the first order and webhook loop before promoting traffic.

Get API accessAuth & webhooks
Developer loginAgent Integration
1

Create a dedicated production or test API key and keep it outside source control.

2

Send a first authenticated request to confirm the branded API base and key both work.

3

Create the first order or checkout flow using the same merchant-native contract.

4

Configure a webhook destination, send a test event, and verify signature handling before promoting traffic.

First authenticated call

Use the branded public API base and the X-API-Key header to verify the integration environment before building deeper order flows.

curl https://api.pivota.cc/agent/v1/merchants \
  -H "X-API-Key: YOUR_API_KEY"

First order path

Move from authenticated requests into merchant-native execution by creating the first order flow on the same API contract. Then inspect order events and webhook delivery.

curl -X POST "https://api.pivota.cc/agent/v1/orders/create" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "merchant_id": "merch_...",
    "customer_email": "buyer@example.com",
    "items": [
      {
        "product_id": "prod_...",
        "variant_id": "var_...",
        "quantity": 1,
        "unit_price": "19.99",
        "subtotal": "19.99"
      }
    ]
  }'

Next: map request families, then wire auth and webhooks.

Once the first call works, move into the callable surface inventory, then finalize webhook delivery and signature verification.

Request typesAuth & webhooks