01 ⊢Create escrow

Create an escrow contract.

Set the amount, the two parties, the verification condition, the deadline, and the fallback. Funding happens after creation through stablecoin rails or the sandbox Stripe checkout path.

Amount (USDC)

Gas reserve tip (%)

Optional payer tip to cover vault gas. Adds $0.00. Funding total $1.00. Provider payout stays the escrow amount.

Client

Client identifier, email, wallet, or agent id. The client funds after the contract is created.

Provider

Provider identifier or payout wallet. Settlement is recorded only after payout confirmation.

Condition

repo

Format: owner/name

pr number

url

sha256 optional

url

expected_status defaults to 200

expected_body substring match, optional

Deadline

Fallback

Cancel

Endpoint POST /escrow/create

Request body live preview

{
  "amount_usdc": 1,
  "gas_tip_percent": 0,
  "client_wallet": "0xclient",
  "provider_wallet": "0xprovider",
  "condition": {
    "type": "manual",
    "params": {},
    "deadline": "…",
    "fallback": "return_to_client"
  }
}

Wire

// 1. create the escrow
curl -X POST https://settle.ronakdaya.com/escrow/create \
  -H 'content-type: application/json' \
  -d '…'

// 2. sandbox human checkout path
curl -i -X POST https://settle.ronakdaya.com/escrow/{id}/checkout

// or: primary stablecoin rail discovery
curl -i -X POST https://settle.ronakdaya.com/escrow/{id}/pay

// 3. rail webhook moves state to held