---
title: "Cancel Escrow"
method: POST
path: "/trdp/escrow/cancel"
tags: ["Escrow"]
---

# Cancel Escrow

`POST /trdp/escrow/cancel`

## Request

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

Cancel an existing escrow transaction and initiate buyer refund if applicable.

## Headers

- `x-api-secret` string, required

## Request body

- CancelEscrowRequest
  - `escrowId` string, required: Unique escrow transaction identifier to cancel.

## Response `200`

Escrow cancelled successfully.

- EscrowCancelResponse
  - `status` string, required
  - `timestamp` string, date-time, required
  - `message` string, required
  - `data` object, required
    - `escrow_id` string
    - `status` string
    - `cancelled_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/cancel/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)