Skip to content

Release escrow ​

http
POST /api/trades/:id/release

User · seller only

Sends the escrowed XLM to the buyer and merges the remaining reserve back to the seller. Irreversible.

Preconditions ​

  • Trade is ESCROW_LOCKED or PAID

Sequence ​

  1. Claim → RELEASING.
  2. Submit the release transaction (payment, remove signer, merge).
  3. → COMPLETED with releaseTxHash and completedAt; write ESCROW_RELEASE ledger entry and system message; emit trade:updated.

Response 200 ​

Updated trade details with links.release.

Errors ​

StatusCodeCause
403FORBIDDENNot the seller
409CONFLICTWrong status or concurrent change
502STELLAR_TX_FAILEDRejected; status restored, safe to retry
503HORIZON_UNAVAILABLEOutcome unknown; trade stays RELEASING until reconciled — don't retry

Nexlm is a peer-to-peer facilitator and never holds customer Naira.