Skip to main content

Getting Started

This guide will help you get started with Triple's Dispute Management API. Use our API to evaluate card disputes, get confidence scores, and receive actionable recommendations.

Prerequisites​

Before you begin, you'll need:

  • A Triple account with API access
  • Access to authorization and clearing data for your disputes
  • HTTPS endpoint for receiving webhook notifications (recommended)

Integration Overview​

Triple integrates with your existing dispute workflow through a REST API.

Integration Overview

Step 1: Get Your API Key​

API keys are managed through the Triple Dashboard. To create an API key:

  1. Log in to your Triple Dashboard
  2. Navigate to Settings → API Keys
  3. Click Create API Key
  4. Copy and securely store your key
caution

Your API key will only be shown once. Store it securely and never expose it in client-side code.

Step 2: Submit Your First Evaluation​

Make a POST request to create an evaluation:

curl -X POST https://api.disputes.play.tripledev.app/api/evaluations/ \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "category": "fraud_online",
  "dispute": {
    "disputed_amount": 299.99,
    "disputed_currency": "USD"
  },
  "transaction": {
    "transaction_id": "txn_12345",
    "card_scheme": "MC",
    "channel_type": "ECOMMERCE",
    "merchant_name": "ACME Store",
    "merchant_country": "USA",
    "transaction_amount": 299.99,
    "transaction_currency": "USD",
    "merchant_id": "MERCHANT123",
    "transaction_timestamp": "2024-01-20T10:30:00Z",
    "settlement_timestamp": "2024-01-22T00:00:00Z",
    "arn": "12345678901234567890123",
    "rrn": "123456789012",
    "merchant_category_code": "5311",
    "terminal_id": "term_01",
    "mobile_wallet": null,
    "avs_result": "NO_MATCH",
    "cvv_match": false,
    "eci_code": "05",
    "batch_id": "batch_001"
  },
  "evidences": {
    "cardholder_statement": "I did not make this purchase. My card was in my possession at all times."
  }
}'

The API returns an evaluation ID:

{
  "id": "550e8400-e29b-41d4-a716-446655440000"
}
Important

Store this ID — you'll need it to retrieve the evaluation result.

Step 3: Receive Results​

Evaluations are processed asynchronously. The recommended way to receive results is by configuring a webhook endpoint — your server will receive an HTTP POST with the result as soon as the evaluation has finished.

As a fallback, you can poll the result endpoint using the evaluation ID:

curl https://api.disputes.play.tripledev.app/api/evaluations/{evaluation_id}/result \
-H "Authorization: Bearer $API_KEY"

The result contains:

  • Confidence level — high, moderate_high, moderate_low, or low
  • Failed checks — Specific issues that affected the confidence score
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "confidence": "high",
  "failed_checks": []
}

Next Steps​