Jèko
Escrows

Refund escrow (Partner API)

POST
/partner_api/escrows/{id}/refund

Refunds a held escrow to the original payer.

Principal leaves the escrow wallet via the PSP change path. Partner GET /transactions stays empty for this job.

Access: platform key only.

Authorization

ApiKey ApiKeyId
X-API-KEY<token>

In: header

X-API-KEY-ID<token>

In: header

Path Parameters

id*string

Escrow identifier

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/partner_api/escrows/497f6eca-6276-4993-bfeb-53cbbbba6f08/refund"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "storeId": "b8adcdc8-9238-4168-90f8-77b2d14c211c",  "status": "pending",  "holdUntil": "2019-08-24T14:15:22Z",  "amount": {    "amount": 0,    "currency": "string"  },  "paymentRequestId": "e1d5fdf3-f4c6-4ab6-a2c0-11174dd3f66b",  "paymentLinkId": "65854dcb-f544-4848-b04d-cccad43b01a8",  "createdAt": "2019-08-24T14:15:22Z"}

Get escrow by ID (Partner API) GET

Returns one escrow by id, including hold lifecycle status. **Access:** platform key only. Other merchants receive 404.

Release escrow (Partner API) POST

Releases a held escrow to the merchant operating wallet. Creates one Partner `type=escrow` transaction. Only this merchant's platform key can unlock. Double release is 409. **Access:** platform key only.