Release Locked Escrow Funds — POST /api/escrow/release

Releasing an escrow requires both the depositor and the beneficiary to confirm delivery. Call this endpoint once per party — the first confirmation puts the escrow in a partially-confirmed state, and the second confirmation triggers the on-chain transfer and marks the escrow RELEASED. The response tells you whether the escrow is fully released or still awaiting the other party.

The callerSCA must exactly match either the depositorSCA or beneficiarySCA recorded at creation. Mismatched addresses will be rejected.

Endpoint

POST https://flarehq.xyz/api/escrow/release

Authentication

Pass your merchant bearer token in the Authorization header.

Authorization: Bearer fhq_sec_...

Request Body

string

required

The escrow reference ID returned by POST /api/escrow/create — e.g. "escrow_m5k2r1_a4b8c2".

string

required

The SCA wallet address that is confirming delivery. Must be either the depositorSCA or beneficiarySCA recorded at escrow creation, and must be a wallet your merchant account controls.

Response

boolean

true when the on-chain confirmation transaction was accepted.

object

The updated escrow record.

Show escrow fields

string

"RELEASED" if both parties have now confirmed. "ACTIVE" if only one party has confirmed so far.

boolean

Whether the depositor has submitted their confirmation.

boolean

Whether the beneficiary has submitted their confirmation.

string

Populated with the final release transaction hash once both parties have confirmed. null until then.

string

The on-chain transaction hash for this release confirmation call.

string

ArcScan link — https://testnet.arcscan.app/tx/{txHash}.

boolean

true if this confirmation completed the release (both parties confirmed). false if still waiting on the other party.

string

A human-readable summary — either confirming full release with the USDC amount and recipient, or indicating which party’s confirmation is still pending.

Examples

curl -X POST https://flarehq.xyz/api/escrow/release \
  -H "Authorization: Bearer fhq_sec_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "escrow_m5k2r1_a4b8c2",
    "callerSCA": "0xDepositorSCAWalletAddress"
  }'

const response = await fetch("https://flarehq.xyz/api/escrow/release", {
  method: "POST",
  headers: {
    "Authorization": "Bearer fhq_sec_YOUR_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    reference: "escrow_m5k2r1_a4b8c2",
    callerSCA: "0xDepositorSCAWalletAddress",
  }),
});

const data = await response.json();
if (data.released) {
  console.log("Escrow fully released:", data.txHash);
} else {
  console.log("Awaiting second confirmation.");
}

Full Release Response (both parties confirmed)

{
  "success": true,
  "escrow": {
    "reference":            "escrow_m5k2r1_a4b8c2",
    "status":               "RELEASED",
    "depositorConfirmed":   true,
    "beneficiaryConfirmed": true,
    "releaseTxHash":        "0xdef456abc789def456abc789def456abc789def456abc789def456abc789def4"
  },
  "txHash":      "0xdef456abc789def456abc789def456abc789def456abc789def456abc789def4",
  "explorerUrl": "https://testnet.arcscan.app/tx/0xdef456abc789...",
  "released":    true,
  "message":     "Escrow fully released — 200 USDC sent to 0xBeneficiarySCAWalletAddress"
}

Partial Confirmation Response (waiting on other party)

{
  "success": true,
  "escrow": {
    "reference":            "escrow_m5k2r1_a4b8c2",
    "status":               "ACTIVE",
    "depositorConfirmed":   true,
    "beneficiaryConfirmed": false,
    "releaseTxHash":        null
  },
  "txHash":      "0xaaa111bbb222ccc333ddd444eee555fff666777888999000aaabbbcccdddeee",
  "explorerUrl": "https://testnet.arcscan.app/tx/0xaaa111bbb222...",
  "released":    false,
  "message":     "Delivery confirmed by depositor — waiting for other party."
}

Error — Escrow Already Released

{
  "success": false,
  "error": "Escrow is RELEASED — cannot release."
}

You cannot release a DISPUTED escrow. If a dispute is active, the FlareHQ arbiter must resolve it first before funds can move.

Overview

Payments

Escrow

Streaming

x402

Agents

Release Locked Escrow Funds — POST /api/escrow/release

Endpoint

Authentication

Request Body

Response

Examples

Full Release Response (both parties confirmed)

Partial Confirmation Response (waiting on other party)

Error — Escrow Already Released

​Endpoint

​Authentication

​Request Body

​Response

​Examples

​Full Release Response (both parties confirmed)

​Partial Confirmation Response (waiting on other party)

​Error — Escrow Already Released

Endpoint

Authentication

Request Body

Response

Examples

Full Release Response (both parties confirmed)

Partial Confirmation Response (waiting on other party)

Error — Escrow Already Released