Using Justt API

Overview

The Justt.ai API allows you to retrieve chargeback data and update chargeback information. If you have integrated Justt.ai with your Payment Service Provider(s) (PSP), you can fetch the list of relevant chargebacks that require enrichment data.

General flow

Get Chargeback List

Endpoint

Get chargeback API reference

GET /chargebacks

Query Parameters

• status (required): The status of the chargeback. Set to needs_response to retrieve chargebacks that require a response.

📘

It is recommended to use date rang filtering to retrieve the relevant subset

Example

curl -X GET "https://api.justt.ai/v1/chargebacks?status=needs_response" 
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

The API will respond with a JSON object containing chargeback data.

{
  "chargebacks": [
    {
      "id": "chargeback_id_123",
      "status": "needs_response",
      "amount": 100.00,
      "currency": "USD",
      "customer_id": "customer_id_456"
      // additional chargeback fields
    },
    // additional chargeback objects
  ]
}

Gathering Relevant Data

Once you have the list of chargebacks that require enrichment data, proceed to gather and provide the necessary information from your internal systems. Ensure a systematic approach to enhance the data completeness and accuracy for each chargeback record.

Follow the data enrichment process diligently to address any information gaps associated with each chargeback. Your attention to detail during this phase contributes significantly to the overall effectiveness of the chargeback resolution workflow.

Adhere to the guidelines specified in the Justt.ai API documentation to ensure a streamlined and efficient data enrichment process.

Update Chargeback Data

Endpoint

Upsert chargeback

PATCH /chargebacks/{id}

Path Parameters

• id (required): The ID of the chargeback to be updated.

Example

curl -X PUT "https://api.justt.ai/v1/chargebacks/chargeback_id_123" 
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" 
-d '{"status": "resolved", "resolution_comment": "Customer provided necessary information."}'

Request Body

The request body should contain the updated information for the chargeback.

{
  "customerName": "Name",
  "customerIp": "10.0.0.1"
  // additional fields to be updated
}