Cancel an escrow transaction

Cancels an escrow transaction. This action moves funds from an internal Tilia Pay escrow wallet back to the buyer. This API call emits an escrow-transaction-update webhook. Can only be called after calling /v2/escrow/<escrow_id/pay. In this flow, the buyer's payment method will be refunded and sellers will not be compensated.

Request
Security:
tilia_auth (write_invoices)
path Parameters
escrow_id
required
string <TUID>

The escrow transaction ID

Responses
200

Successfully cancelled an escrow transaction

400

Invalid escrow transaction ID

401

Unauthorized access.

403

The transaction was rejected

404

Invoice not found.

500

Service unavailable or server error.

post/v2/escrow/{escrow_id}/cancel
Request samples
curl -i -X POST \
  https://invoicing.tilia-inc.com/v2/escrow/:escrow_id/cancel \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
Response samples
application/json
{
  • "id": "esc_1rS7ZIi4RdNzOh1M0f10NrnI4mp",
  • "account_id": "b2ba9a0f-3d75-44e0-968d-be299cda5d80",
  • "escrow_invoice_id": "354121c4-57d2-4317-939f-9af54be4e3fd",
  • "commit_invoice_id": "7ad23f26-4111-4ad0-9c3a-2e0231be70cf",
  • "cancel_invoice_id": "9e56b8b6-1235-46e8-b3a1-6e786151d3ec",
  • "status": "OPEN",
  • "integrator": "tilia",
  • "created": "string",
  • "updated": "string"
}