API reference / Disputes
Let Troopy submit evidence without a person
Grants Troopy the submission of evidence without a person, up to a date at most 90 days out. A dispute goes at once when its amount is at most maxAmount in the currency, its evidence is complete, and the grant sent fewer than dailyCap in the last 24 hours. The others wait for a person. 24 hours before Stripe's deadline, a dispute that still waits goes with the evidence that it has. These never go without a person: a compliance dispute, a claim that looks right, and a dispute that a person let go. An answer can cost Stripe's fee for a contested dispute. Owners and admins.
/api/v1/dispute-settings/auto-submitOther ways to call it
troopy disputes auto-submitIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Body
application/jsonuntil*stringWhen it ends, at most 90 days out
maxAmount*numberThe largest disputed amount that goes at once, in the units of the currency
At most 1000000
currency*stringThe currency of maxAmount, like usd. A dispute in another currency waits for a person
dailyCap*integerDisputes that it sends in 24 hours
At least 1 · At most 50
Response
200 · application/jsondata*object13 properties
on*booleanWhether Troopy reads the disputes of the workspace's payment providers and prepares their evidence
connected*booleanWhether one of those providers is connected in this workspace
providers*array<object>The payment providers that Troopy reads disputes from, and whether this workspace connected each one
3 properties
id*enum<string>stripedodopaymentspaddle
name*stringconnected*booleandescription*string | nullWhat the business sells, as the bank reads it
kind*enum<string>servicesmerchandise
usageFromBackend*booleanWhether the backend of the business sends the usage of the customer for each dispute
refundPolicy*string | nullThe refund policy of the business, in its own words
cancellationPolicy*string | nullThe cancellation policy of the business, in its own words
disclosure*string | nullHow a customer sees the policies before a payment
autoSubmit*object | nullThe grant to submit without a person, while it is in force
6 properties
until*stringISO 8601 date and time
maxAmount*numberThe largest disputed amount that goes without a person, in the units of the currency
currency*stringdailyCap*integergrantedBy*objectWho wrote it
3 properties
type*enum<string>personagentapi
id*stringname*stringgrantedAt*stringISO 8601 date and time
ended*object | nullWhen the last grant ended, and why
2 properties
at*stringISO 8601 date and time
why*stringsyncedAt*string | nullWhen Troopy last read the disputes from the providers
error*string | nullWhat the last read of a provider said, when it failed