Skip to main content
POST
Resolve dispute

Authorizations

Authorization
string
header
required

Your secret key as a Bearer token. The key prefix selects the environment: sk_test_... (staging) or sk_live_... (production); a key on the wrong host is refused with 403 Unauthorized Access. Each key is limited to 10 requests per minute (429 beyond that) and, on production, to the IP addresses on your dashboard allowlist when one is configured.

Path Parameters

escrowId
string
required

The escrow's unique identifier.

Body

multipart/form-data
resolution
string
required
Example:

"Refund approved after review"

status
enum<string>
required
Available options:
COMPLETED,
REFUNDED,
SPLIT
Example:

"REFUNDED"

sellerAmount
number

Required on a SPLIT resolution, rejected otherwise. The part of the held funds released to the seller. At most two decimal places. Together with buyerAmount it must equal exactly what the escrow still holds.

Example:

30000

buyerAmount
number

Required on a SPLIT resolution, rejected otherwise. The part of the held funds returned to the buyer.

Example:

20000

additionalFeeRefundable
boolean

Optional, and only meaningful on a REFUNDED or SPLIT resolution. true returns the escrow's additionalFee to the buyer, false credits it to your merchant wallet. Saved on the escrow, overriding the value set before payment. Omit to use whatever the escrow already carries.

Example:

true

file
file

Optional supporting document.

Response

Dispute resolved.

status
integer
Example:

200

message
string
Example:

"Operation successful"

data
object