Submit a dispute's answer
Sends a dispute’s answer to its provider, once: what Shoply recorded, Shoply’s PDF of it, the store’s own files, and the statement, in each provider’s own shape. Stripe’s evidence fields; Revolut’s files and a challenge whose comment is the statement’s first 250 characters; PayPal’s evidence, appeal or supporting information, whichever the dispute takes now, with the statement as its notes; Adyen’s documents under a defense reason, the statement in the PDF. It cannot be taken back. Any draft fields in the body are saved first. Answers 409 answered_elsewhere for a dispute answered in its provider’s own dashboard, not_answerable for one not waiting on an answer, past_due once its deadline has passed, and file_not_taken for one of the store’s files the provider does not take (Adyen takes no PNG, and a PDF of up to 2 MB). The provider refusing it is 502, with stripe_key or provider_key where the store’s key or app may not answer disputes, and provider_refused otherwise, the dispute back to a draft with answer.note saying why. A store sends at most 20 answers or acceptances every 10 minutes.
Needs the disputes.write permission (Answer Disputes).
Authorizations
A secret API key, made under Developers in the dashboard: Authorization: Bearer shoply_sk_...
Headers
A word of your own for this one change, up to 180 letters, digits, dots, dashes, underscores and colons. Sent again with the same key, the request is not carried out twice: the first answer comes back, with Idempotent-Replay: true.
Path Parameters
The store's ID. A key reaches the store it was made in: GET /key answers which.
The dispute, by its ID.
Body
Whether to fight it or accept it.
fight, accept Whether the buyer contacted the store before disputing. Empty when not said.
, yes, no Whether they used what they bought, or unknown. Empty when not said.
, yes, unknown The store's statement in its own words, up to 10,000 characters. Sent apart from what Shoply recorded.
Response
It worked.
Whether the request did what was asked.
Words for a person. Empty when it worked.
Why it was refused, as a word that does not change. Empty when it worked.
The thing asked for: an object, or for a list its rows.
For a paged list: how many pages there are.
For a paged list: how many rows there are in all.
Anything else the route answers beside the thing itself.

