Skip to main content
API docs by Redocly

Triple Disputes API (1.0.0)

Download OpenAPI specification:Download

Public API for submitting disputes and retrieving evaluation results.

Intake

Beta. Hosted dispute-capture UI you embed in your app via iframe. Endpoints and payloads are under active development and may change before general availability. Contact your Triple representative to enable intake on your account.

Create an intake session

Beta. Creates a short-lived intake session. Returns a URL you embed in an iframe inside your dispute flow. When the cardholder finishes, Triple classifies the case, runs the evaluation, and notifies your app via postMessage (and webhook, if configured) with the resulting evaluation_id.

The transaction and card objects use the same shape as the evaluations request, so you can pass the same data you already have for evaluations without reshaping it.

Request from your backend only. Your API key must stay server-side.

Authorizations:
BearerAuthentication
Request Body schema: application/json
required
mode
string (IntakeMode)
Enum: "form" "chatbot"

form (multi-step smart form) or chatbot (conversational flow). Defaults to form.

required
object (Transaction)

Transaction details for the disputed charge.

required
object (Card)

Card snapshot for the disputed transaction.

object (IntakeCardholder)

Identifiers you use for this cardholder. Triple does not require any of these but they are useful for reconciliation.

return_url
string <uri>

Where to send the cardholder after they finish (shown as a button at the end of the flow).

Responses

Request samples

Content type
application/json
{
  • "mode": "form",
  • "transaction": {
    },
  • "card": {
    },
  • "cardholder": {
    },
  • "return_url": "https://issuer.example.com/disputes/done"
}

Response samples

Content type
application/json
{}

Evaluations

Create an evaluation

Submit a dispute with evidence for automated evaluation.

Authorizations:
BearerAuthentication
Request Body schema: application/json
required
One of
required
object (Dispute)

Dispute details including the disputed amount and currency.

required
object (Transaction)

Transaction being disputed.

required
object (Card)

Card snapshot for the disputed transaction.

required
object (FraudEvidences)

Evidence for fraud disputes.

Responses

Request samples

Content type
application/json
Example
{
  • "dispute": {
    },
  • "transaction": {
    },
  • "card": {
    },
  • "evidences": {
    }
}

Get evaluation result

Retrieve the evaluation confidence and any failed checks.

Authorizations:
BearerAuthentication
path Parameters
evaluation_id
required
string <uuid> (Evaluation Id)

Responses

Response samples

Content type
application/json
{
  • "id": "eval_a1b2c3",
  • "confidence": "high",
  • "reason_code": "10.4",
  • "failed_checks": [
    ]
}

Files

Upload an evidence file

Upload an evidence file and receive its id for use in evaluations.

Authorizations:
BearerAuthentication
Request Body schema: multipart/form-data
required
file
required
string <binary> (File)

Responses

Response samples

Content type
application/json
{}

Get file metadata and signed URL

Retrieve metadata and a signed URL for an evidence file.

Authorizations:
BearerAuthentication
path Parameters
file_id
required
string <uuid> (File Id)

Responses

Response samples

Content type
application/json
{}