STstarpayethiopia
Escrow

Release Escrow Allocation

Changed on

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

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

Headers

x-api-secretstring required
Example:SplFeYdc/Hc5S1CGmVDtETLYUJY/10a38ejamzwb1YH30h+u8sOK2fpTlyKitpPk

Your StarPay API secret key.

Request body

escrowIdstring required

Unique escrow transaction identifier.

merchantIdstring required

Merchant ID to receive payout.

Example request

{
  "escrowId": "59667344",
  "merchantId": "01344351"
}

Response

Escrow allocation released successfully.

statusstring required
timestampstring date-time required
messagestring required

Example response

{
  "status": "success",
  "timestamp": "2026-07-29T11:00:00Z",
  "message": "Escrow allocation released successfully",
  "data": {
    "escrow_id": "59667344",
    "merchant_id": "01344351",
    "amount": 3000,
    "release_status": "RELEASED",
    "released_at": "2026-07-29T11:00:00Z"
  }
}

Changes