Get dispute history

curl --request POST \
  --url https://sandbox-platform.jupico.com/v1/query/disputes/chartslines \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://sandbox-platform.jupico.com/v1/query/disputes/chartslines"

payload = {}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://sandbox-platform.jupico.com/v1/query/disputes/chartslines', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const url = 'https://sandbox-platform.jupico.com/v1/query/disputes/chartslines';
const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

{
  "success": true,
  "message": "succeeded",
  "code": "0",
  "data": [
    {
      "spProductId": "255",
      "facId": "JPT",
      "transactionId": "b164e6e2-791c-4831-aefd-003de4d71085",
      "txReceivedDate": "210606",
      "txType": "41",
      "disputeAmount": "0000020773",
      "disputeAmountPretty": "207.73",
      "networkId": "VISA",
      "draftRetrievalNumber": "231268787",
      "recordNumber": "112710461802",
      "originalTxDate": "10414",
      "originalTxTime": "732004",
      "merchantChainNumberFromOriginalTx": "6416Y",
      "divisionNumberFromOriginalTx": "000",
      "totalSegments": "2",
      "terminalId": "01",
      "registerNumber": "0000",
      "chargebackUsageCode": "C",
      "adjustmentType": "HBK2",
      "draftActionCode": "",
      "draftActionCodeDate": "",
      "documentIndicator": "1",
      "primaryAccountNumber": "53506XXXXXX6148   M",
      "chargebackActionCode": "ACP2",
      "chargebackActionCodeDate": "106060",
      "departmentNumber": "00008",
      "issuerCurrencyCode": "405",
      "merchantCategoryCode": "812V",
      "adjustmentReasonCode": "04  0",
      "chargebackReferenceCode": "020870072561",
      "dispositionQualifier": "022",
      "aRN": "44450011043004499215196",
      "merchantChain": "416Y",
      "merchantDivisionNumber": "0",
      "feeAmount": "0.00",
      "salesPersonNumber": "000000000",
      "entryMode": "1",
      "authorizationSource": "7",
      "previousDraftAction": "",
      "electronicCommerce": "",
      "userDataField1": "",
      "userDataField2": "",
      "userDataField3": "",
      "userDataField4": "",
      "commentsFromIssuer": "",
      "commentsToIssuer": "",
      "commentToMerchant": "",
      "commentsFromMerchant": "",
      "merchantStoreNumber": "000000092",
      "updatedAt": "2024-04-19T00:14:51.690Z",
      "createdAt": "2023-04-28T16:46:36.516Z"
    }
  ],
  "totals": {
    "count": 2
  },
  "count": 2,
  "query": {
    "criteria": {},
    "options": {
      "limit": 1000,
      "projection": {
        "_id": 0,
        "spProductId": 1,
        "facId": 1,
        "transactionId": 1,
        "txReceivedDate": 1,
        "txType": 1,
        "disputeAmount": 1,
        "disputeAmountPretty": 1,
        "networkId": 1,
        "draftRetrievalNumber": 1,
        "recordNumber": 1,
        "originalTxDate": 1,
        "originalTxTime": 1,
        "merchantChainNumberFromOriginalTx": 1,
        "divisionNumberFromOriginalTx": 1,
        "totalSegments": 1,
        "terminalId": 1,
        "registerNumber": 1,
        "chargebackUsageCode": 1,
        "adjustmentType": 1,
        "draftActionCode": 1,
        "draftActionCodeDate": 1,
        "documentIndicator": 1,
        "primaryAccountNumber": 1,
        "chargebackActionCode": 1,
        "chargebackActionCodeDate": 1,
        "departmentNumber": 1,
        "issuerCurrencyCode": 1,
        "merchantCategoryCode": 1,
        "adjustmentReasonCode": 1,
        "chargebackReferenceCode": 1,
        "dispositionQualifier": 1,
        "aRN": 1,
        "merchantChain": 1,
        "merchantDivisionNumber": 1,
        "feeAmount": 1,
        "salesPersonNumber": 1,
        "entryMode": 1,
        "authorizationSource": 1,
        "previousDraftAction": 1,
        "electronicCommerce": 1,
        "userDataField1": 1,
        "userDataField2": 1,
        "userDataField3": 1,
        "userDataField4": 1,
        "commentsFromIssuer": 1,
        "commentsToIssuer": 1,
        "commentToMerchant": 1,
        "commentsFromMerchant": 1,
        "merchantStoreNumber": 1,
        "updatedAt": 1,
        "createdAt": 1
      }
    }
  }
}

POST

https://sandbox-platform.jupico.com

query

disputes

chartslines

Get dispute history

curl --request POST \
  --url https://sandbox-platform.jupico.com/v1/query/disputes/chartslines \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://sandbox-platform.jupico.com/v1/query/disputes/chartslines"

payload = {}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://sandbox-platform.jupico.com/v1/query/disputes/chartslines', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const url = 'https://sandbox-platform.jupico.com/v1/query/disputes/chartslines';
const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

{
  "success": true,
  "message": "succeeded",
  "code": "0",
  "data": [
    {
      "spProductId": "255",
      "facId": "JPT",
      "transactionId": "b164e6e2-791c-4831-aefd-003de4d71085",
      "txReceivedDate": "210606",
      "txType": "41",
      "disputeAmount": "0000020773",
      "disputeAmountPretty": "207.73",
      "networkId": "VISA",
      "draftRetrievalNumber": "231268787",
      "recordNumber": "112710461802",
      "originalTxDate": "10414",
      "originalTxTime": "732004",
      "merchantChainNumberFromOriginalTx": "6416Y",
      "divisionNumberFromOriginalTx": "000",
      "totalSegments": "2",
      "terminalId": "01",
      "registerNumber": "0000",
      "chargebackUsageCode": "C",
      "adjustmentType": "HBK2",
      "draftActionCode": "",
      "draftActionCodeDate": "",
      "documentIndicator": "1",
      "primaryAccountNumber": "53506XXXXXX6148   M",
      "chargebackActionCode": "ACP2",
      "chargebackActionCodeDate": "106060",
      "departmentNumber": "00008",
      "issuerCurrencyCode": "405",
      "merchantCategoryCode": "812V",
      "adjustmentReasonCode": "04  0",
      "chargebackReferenceCode": "020870072561",
      "dispositionQualifier": "022",
      "aRN": "44450011043004499215196",
      "merchantChain": "416Y",
      "merchantDivisionNumber": "0",
      "feeAmount": "0.00",
      "salesPersonNumber": "000000000",
      "entryMode": "1",
      "authorizationSource": "7",
      "previousDraftAction": "",
      "electronicCommerce": "",
      "userDataField1": "",
      "userDataField2": "",
      "userDataField3": "",
      "userDataField4": "",
      "commentsFromIssuer": "",
      "commentsToIssuer": "",
      "commentToMerchant": "",
      "commentsFromMerchant": "",
      "merchantStoreNumber": "000000092",
      "updatedAt": "2024-04-19T00:14:51.690Z",
      "createdAt": "2023-04-28T16:46:36.516Z"
    }
  ],
  "totals": {
    "count": 2
  },
  "count": 2,
  "query": {
    "criteria": {},
    "options": {
      "limit": 1000,
      "projection": {
        "_id": 0,
        "spProductId": 1,
        "facId": 1,
        "transactionId": 1,
        "txReceivedDate": 1,
        "txType": 1,
        "disputeAmount": 1,
        "disputeAmountPretty": 1,
        "networkId": 1,
        "draftRetrievalNumber": 1,
        "recordNumber": 1,
        "originalTxDate": 1,
        "originalTxTime": 1,
        "merchantChainNumberFromOriginalTx": 1,
        "divisionNumberFromOriginalTx": 1,
        "totalSegments": 1,
        "terminalId": 1,
        "registerNumber": 1,
        "chargebackUsageCode": 1,
        "adjustmentType": 1,
        "draftActionCode": 1,
        "draftActionCodeDate": 1,
        "documentIndicator": 1,
        "primaryAccountNumber": 1,
        "chargebackActionCode": 1,
        "chargebackActionCodeDate": 1,
        "departmentNumber": 1,
        "issuerCurrencyCode": 1,
        "merchantCategoryCode": 1,
        "adjustmentReasonCode": 1,
        "chargebackReferenceCode": 1,
        "dispositionQualifier": 1,
        "aRN": 1,
        "merchantChain": 1,
        "merchantDivisionNumber": 1,
        "feeAmount": 1,
        "salesPersonNumber": 1,
        "entryMode": 1,
        "authorizationSource": 1,
        "previousDraftAction": 1,
        "electronicCommerce": 1,
        "userDataField1": 1,
        "userDataField2": 1,
        "userDataField3": 1,
        "userDataField4": 1,
        "commentsFromIssuer": 1,
        "commentsToIssuer": 1,
        "commentToMerchant": 1,
        "commentsFromMerchant": 1,
        "merchantStoreNumber": 1,
        "updatedAt": 1,
        "createdAt": 1
      }
    }
  }
}

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

The body is of type object.

Response

200 - application/json

findDisputesChartLines

success

boolean

Whether the request was processed successfully. Declines return HTTP 200 with success: false.

Example:

true

message

string

Human-readable result message.

Example:

"succeeded"

code

string

Machine-readable result code. See the Error Codes reference.

Example:

"0"

data

object[]

The response payload.

Hide child attributes

data.spProductId

string

Identifier of the Service Provider product the merchant belongs to.

Example:

"255"

data.facId

string

Facilitator identifier assigned by Jupico.

Example:

"JPT"

data.transactionId

string

Unique identifier of the original transaction.

Example:

"b164e6e2-791c-4831-aefd-003de4d71085"

data.txReceivedDate

string

Date the dispute record was received (network format).

Example:

"210606"

data.txType

string

Transaction type code from the network.

Example:

"41"

data.disputeAmount

string

Amount in dispute.

Example:

"0000020773"

data.disputeAmountPretty

string

Dispute amount formatted for display.

Example:

"207.73"

data.networkId

string

Card network identifier.

Example:

"VISA"

data.draftRetrievalNumber

string

Draft retrieval reference number.

Example:

"231268787"

data.recordNumber

string

Record number within the dispute file.

Example:

"112710461802"

data.originalTxDate

string

Date of the original transaction (network format).

Example:

"10414"

data.originalTxTime

string

Time of the original transaction (network format).

Example:

"732004"

data.merchantChainNumberFromOriginalTx

string

Merchant chain number from the original transaction.

Example:

"6416Y"

data.divisionNumberFromOriginalTx

string

Merchant division number from the original transaction.

Example:

"000"

data.totalSegments

string

Number of segments in the dispute record.

Example:

"2"

data.terminalId

string

Terminal ID from the original transaction.

Example:

"01"

data.registerNumber

string

Example:

"0000"

data.chargebackUsageCode

string

Chargeback usage code (first or subsequent presentment).

Example:

"C"

data.adjustmentType

string

Adjustment type code.

Example:

"HBK2"

data.draftActionCode

string

Draft action code.

Example:

""

data.draftActionCodeDate

string

Date of the draft action (network format).

Example:

""

data.documentIndicator

string

Indicates whether supporting documentation exists.

Example:

"1"

data.primaryAccountNumber

string

Masked primary account number (PAN).

Example:

"53506XXXXXX6148 M"

data.chargebackActionCode

string

Chargeback action code.

Example:

"ACP2"

data.chargebackActionCodeDate

string

Date of the chargeback action (network format).

Example:

"106060"

data.departmentNumber

string

Department number from the original transaction.

Example:

"00008"

data.issuerCurrencyCode

string

Currency code used by the issuer.

Example:

"405"

data.merchantCategoryCode

string

Merchant category code (MCC) of the original transaction.

Example:

"812V"

data.adjustmentReasonCode

string

Adjustment reason code from the network.

Example:

"04 0"

data.chargebackReferenceCode

string

Chargeback reference assigned by the network.

Example:

"020870072561"

data.dispositionQualifier

string

Disposition qualifier code.

Example:

"022"

data.aRN

string

Acquirer reference number (ARN) for the disputed transaction.

Example:

"44450011043004499215196"

data.merchantChain

string

Merchant chain number.

Example:

"416Y"

data.merchantDivisionNumber

string

Merchant division number.

Example:

"0"

data.feeAmount

string

Fee amount.

Example:

"0.00"

data.salesPersonNumber

string

Salesperson number from the original transaction.

Example:

"000000000"

data.entryMode

string

Card entry mode of the original transaction.

Example:

"1"

data.authorizationSource

string

Authorization source code from the original transaction.

Example:

"7"

data.previousDraftAction

string

Previous draft action code.

Example:

""

data.electronicCommerce

string

E-commerce indicator from the original transaction.

Example:

""

data.userDataField1

string

Network user data field.

Example:

""

data.userDataField2

string

Network user data field.

Example:

""

data.userDataField3

string

Network user data field.

Example:

""

data.userDataField4

string

Network user data field.

Example:

""

data.commentsFromIssuer

string

Comments from the issuing bank.

Example:

""

data.commentsToIssuer

string

Comments sent to the issuing bank.

Example:

""

data.commentToMerchant

string

Comment addressed to the merchant.

Example:

""

data.commentsFromMerchant

string

Comments submitted by the merchant.

Example:

""

data.merchantStoreNumber

string

Merchant store number.

Example:

"000000092"

data.updatedAt

string

Timestamp when the object was last updated (ISO 8601).

Example:

"2024-04-19T00:14:51.690Z"

data.createdAt

string

Timestamp when the object was created (ISO 8601).

Example:

"2023-04-28T16:46:36.516Z"

totals

object

Aggregate totals across all returned records.

Hide child attributes

totals.count

integer

Number of records.

Example:

2

count

integer

Number of records.

Example:

2

query

object

Echo of the query envelope that produced this result.

Hide child attributes

query.criteria

object

Filter criteria applied, keyed by field path.

Example:

{}

query.options

object

Query options: pagination, sorting, and field projection.

Hide child attributes

query.options.limit

integer

Maximum number of records returned.

Example:

1000

query.options.projection

object

Field projection applied to results.

Hide child attributes

query.options.projection._id

integer

Internal document identifier.

Example:

0

query.options.projection.spProductId

integer

Identifier of the Service Provider product the merchant belongs to.

Example:

1

query.options.projection.facId

integer

Facilitator identifier assigned by Jupico.

Example:

1

query.options.projection.transactionId

integer

Unique identifier of the original transaction.

Example:

1

query.options.projection.txReceivedDate

integer

Date the dispute record was received (network format).

Example:

1

query.options.projection.txType

integer

Transaction type code from the network.

Example:

1

query.options.projection.disputeAmount

integer

Amount in dispute.

Example:

1

query.options.projection.disputeAmountPretty

integer

Dispute amount formatted for display.

Example:

1

query.options.projection.networkId

integer

Card network identifier.

Example:

1

query.options.projection.draftRetrievalNumber

integer

Draft retrieval reference number.

Example:

1

query.options.projection.recordNumber

integer

Record number within the dispute file.

Example:

1

query.options.projection.originalTxDate

integer

Date of the original transaction (network format).

Example:

1

query.options.projection.originalTxTime

integer

Time of the original transaction (network format).

Example:

1

query.options.projection.merchantChainNumberFromOriginalTx

integer

Merchant chain number from the original transaction.

Example:

1

query.options.projection.divisionNumberFromOriginalTx

integer

Merchant division number from the original transaction.

Example:

1

query.options.projection.totalSegments

integer

Number of segments in the dispute record.

Example:

1

query.options.projection.terminalId

integer

Terminal ID from the original transaction.

Example:

1

query.options.projection.registerNumber

integer

Example:

1

query.options.projection.chargebackUsageCode

integer

Chargeback usage code (first or subsequent presentment).

Example:

1

query.options.projection.adjustmentType

integer

Adjustment type code.

Example:

1

query.options.projection.draftActionCode

integer

Draft action code.

Example:

1

query.options.projection.draftActionCodeDate

integer

Date of the draft action (network format).

Example:

1

query.options.projection.documentIndicator

integer

Indicates whether supporting documentation exists.

Example:

1

query.options.projection.primaryAccountNumber

integer

Masked primary account number (PAN).

Example:

1

query.options.projection.chargebackActionCode

integer

Chargeback action code.

Example:

1

query.options.projection.chargebackActionCodeDate

integer

Date of the chargeback action (network format).

Example:

1

query.options.projection.departmentNumber

integer

Department number from the original transaction.

Example:

1

query.options.projection.issuerCurrencyCode

integer

Currency code used by the issuer.

Example:

1

query.options.projection.merchantCategoryCode

integer

Merchant category code (MCC) of the original transaction.

Example:

1

query.options.projection.adjustmentReasonCode

integer

Adjustment reason code from the network.

Example:

1

query.options.projection.chargebackReferenceCode

integer

Chargeback reference assigned by the network.

Example:

1

query.options.projection.dispositionQualifier

integer

Disposition qualifier code.

Example:

1

query.options.projection.aRN

integer

Acquirer reference number (ARN) for the disputed transaction.

Example:

1

query.options.projection.merchantChain

integer

Merchant chain number.

Example:

1

query.options.projection.merchantDivisionNumber

integer

Merchant division number.

Example:

1

query.options.projection.feeAmount

integer

Fee amount.

Example:

1

query.options.projection.salesPersonNumber

integer

Salesperson number from the original transaction.

Example:

1

query.options.projection.entryMode

integer

Card entry mode of the original transaction.

Example:

1

query.options.projection.authorizationSource

integer

Authorization source code from the original transaction.

Example:

1

query.options.projection.previousDraftAction

integer

Previous draft action code.

Example:

1

query.options.projection.electronicCommerce

integer

E-commerce indicator from the original transaction.

Example:

1

query.options.projection.userDataField1

integer

Network user data field.

Example:

1

query.options.projection.userDataField2

integer

Network user data field.

Example:

1

query.options.projection.userDataField3

integer

Network user data field.

Example:

1

query.options.projection.userDataField4

integer

Network user data field.

Example:

1

query.options.projection.commentsFromIssuer

integer

Comments from the issuing bank.

Example:

1

query.options.projection.commentsToIssuer

integer

Comments sent to the issuing bank.

Example:

1

query.options.projection.commentToMerchant

integer

Comment addressed to the merchant.

Example:

1

query.options.projection.commentsFromMerchant

integer

Comments submitted by the merchant.

Example:

1

query.options.projection.merchantStoreNumber

integer

Merchant store number.

Example:

1

query.options.projection.updatedAt

integer

Timestamp when the object was last updated (ISO 8601).

Example:

1

query.options.projection.createdAt

integer

Timestamp when the object was created (ISO 8601).

Example:

1

API Overview

API Reference

Resources

Get dispute history

Authorizations

Body

Response