---
title: "Release Escrow Allocation"
method: POST
path: "/trdp/escrow/release"
tags: ["Escrow"]
---

# Release Escrow Allocation

`POST /trdp/escrow/release`

## Request

- Base URL: `https://sandbox-api.starpayethiopia.com/v1/starpay-api`
- URL: `https://sandbox-api.starpayethiopia.com/v1/starpay-api/trdp/escrow/release`
- Auth: none declared. Required headers: `x-api-secret`

Release held escrow funds for a specific merchant allocation upon successful order fulfillment.

## Headers

- `x-api-secret` string, required

## Request body

- ReleaseEscrowAllocationRequest
  - `escrowId` string, required: Unique escrow transaction identifier.
  - `merchantId` string, required: Merchant ID to receive payout.

## Response `200`

Escrow allocation released successfully.

- EscrowReleaseResponse
  - `status` string, required
  - `timestamp` string, date-time, required
  - `message` string, required
  - `data` object, required
    - `escrow_id` string
    - `merchant_id` string
    - `amount` number
    - `release_status` string
    - `released_at` string, date-time

## Other responses

- `400`: Bad request.
- `401`: Unauthorized.
- `404`: Not found.
- `500`: internal.

## Changes

- **2026-11-03** `dac09da89d94`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/starpayethiopia/apis/starpay-api/changes/trdp/escrow/release/post.md)

---

[API](https://skmtc.dev/starpayethiopia/apis/starpay-api.md) - [All operations](https://skmtc.dev/starpayethiopia/apis/starpay-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starpayethiopia/apis/starpay-api/revisions/dac09da89d94?raw)