Release escrow
http
POST /api/trades/:id/releaseUser · seller only
Sends the escrowed XLM to the buyer and merges the remaining reserve back to the seller. Irreversible.
Preconditions
- Trade is
ESCROW_LOCKEDorPAID
Sequence
- Claim
→ RELEASING. - Submit the release transaction (payment, remove signer, merge).
→ COMPLETEDwithreleaseTxHashandcompletedAt; writeESCROW_RELEASEledger entry and system message; emittrade:updated.
Response 200
Updated trade details with links.release.
Errors
| Status | Code | Cause |
|---|---|---|
| 403 | FORBIDDEN | Not the seller |
| 409 | CONFLICT | Wrong status or concurrent change |
| 502 | STELLAR_TX_FAILED | Rejected; status restored, safe to retry |
| 503 | HORIZON_UNAVAILABLE | Outcome unknown; trade stays RELEASING until reconciled — don't retry |