Skip to main content
POST
Submit 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.

Headers

customer-id
string
required

The merchant customer this request acts on behalf of.

Path Parameters

paymentToken
string
required

The escrow's payment token (e.g. PY_8AB12C9D3045).

Body

multipart/form-data
message
string
required
Example:

"Item not as described"

file
file

Optional evidence attachment.

Response

Dispute submitted.

status
integer
Example:

200

message
string
Example:

"Operation successful"

data
object