Skip to main content
POST
/
escrow-refund
Issue an admin refund
curl --request POST \
  --url https://aarwcjjzhlmkgdwrisyt.supabase.co/functions/v1/escrow-refund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "escrow_id": "d4e5f6a7-b8c9-0123-defa-234567890123",
  "reason": "Seller failed to deliver goods after 14 days. Refund authorised by support team."
}
'
{
  "success": true,
  "status": 200,
  "data": {
    "escrow_id": "d4e5f6a7-b8c9-0123-defa-234567890123"
  }
}

Authorizations

​
Authorization
string
header
required

JWT access token obtained from /auth-verify (login context) or /auth-signup. Set the bearer_token environment variable in your API client to apply it globally.

Body

application/json
​
escrow_id
string<uuid>
required

The escrow to refund.

​
reason
string
required

Admin-provided reason for the refund. Stored for audit purposes.

Required string length: 10 - 2000
Example:

"Seller failed to deliver goods after 14 days. Refund authorised by support team."

Response

Escrow refunded — payer's wallet credited

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
data
object