Obtener reclamo por ID

Obtener información de una reclamación

curl --request GET \
  --url https://e3-kausanna.sonqo.io/claims/{claimId} \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "id": "208171594972",
    "primaryAccountNumber": "5505********9697",
    "origin": "mastercard",
    "outcome": "in_progress",
    "authCode": "658119",
    "flow": {
      "currentStep": "SECOND_PRESENTATION_STARTED"
    },
    "rrn": "08032054026003400006298",
    "status": "SECOND_PRESENTATION_STARTED",
    "transactionId": "TI:bnMeLTGLm2Q7jllvf_Of6eHBL7Ef6KRkL-uNEUnhyV7Lgb8piMeU5altPIJpo5DKzBzC3ZGZ-1JVkUmA2a4FGkRm4gpibshDMuDAKk6jb6M=##ACQ",
    "isOpen": true,
    "partnerId": "01HPWX95S4ZNNKPMNKPDKE2E12",
    "acquirerId": "032314",
    "issuerId": "017670",
    "seen": false,
    "events": [
      {
        "name": "CREATED",
        "timestamp": "2024-03-05T19:51:58.202Z"
      },
      {
        "name": "SECOND_PRESENTATION_STARTED",
        "timestamp": "2024-03-05T19:51:58.202Z"
      }
    ],
    "createdAt": "2024-03-05T19:51:58.202Z",
    "updatedAt": "2024-03-05T19:54:01.709Z",
    "amount": 111916.69,
    "currency": "ARS",
    "merchant": {
      "storeId": "9b7396a2-9e60-4bd0-b2f6-5c4f911167b1",
      "ownerId": "2c671a9d-5d66-413e-88b2-aca5c3b6219d",
      "name": "Sip smart coffee",
      "mcc": "5921",
      "taxId": "30123452209",
      "taxIdType": "arg.cuit",
      "externalPaymentId": "05cfc7cd-6551-44d1-bf02-0d87a151046e",
      "contact": {
        "email": "No data",
        "phone": "No data",
        "businessName": "SIPECOFFEE SRL",
        "country": "ARG"
      },
      "address": {
        "country": "ARG",
        "address": {
          "number": "1130",
          "notes": "-",
          "street": "migueletes"
        },
        "city": "CIUDAD AUTONOMA BUENOS AIRES",
        "name": "Torre Galicia ok",
        "id": "35ba1a0c-fb37-41c5-a28d-9208adf4ad9c",
        "state": "C",
        "zip_code": "C1426BUP"
      }
    },
    "payment": {
      "data_privacy": {
        "encrypted": {
          "data": "x5tZYXEw0Cej9PHEENbigCoFe2wW+B2qXiVnHeWpu9nLcgMIldmAt708raupdppqwTBtrETeatwFPtZEAeh4z6ZPy/FPLGlZ9jWc35R2NH+ZtaOeuxTqPuR2oVcn6u8a7VA19hrbaRT2408b+bpeIfUkC0wrusqDMhVnn4pVrSnl08pyNYyXaDvYllifDE3R61+jzPbSzaVRKJ/C21IF15yIIm48a+D9Pdcxo10S7xNNyy/FjPD0q9u2VONBbruRURvT2RWey8zNMDpASYV/AClmRScyn/r/599kBWNoMnmbTZb08eSYz51eFAzhxq+7CpzRkmsW7o0QrSgLD+c4lg==",
          "origin": "non_present"
        }
      },
      "card_method_type": "encrypted",
      "card_holder_name": "Eze Calonge",
      "wallet_name": "galicia",
      "card_holder_doc_type": "DNI",
      "type": "card_payment",
      "expiration_date": "06/2028",
      "card_type": "CREDIT",
      "card_holder_email": "[email protected]",
      "expiration_year": "2028",
      "product_id": "MASTERCARD",
      "expiration_month": "06",
      "name": "MASTERCARD",
      "pan": "550568******6713",
      "card_holder_doc_number": "12345678",
      "QRName": "bb22707a-457e-4695-a29d-8ed76d4bbe85"
    }
  }
}

GET

claims

{claimId}

Obtener información de una reclamación

curl --request GET \
  --url https://e3-kausanna.sonqo.io/claims/{claimId} \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "id": "208171594972",
    "primaryAccountNumber": "5505********9697",
    "origin": "mastercard",
    "outcome": "in_progress",
    "authCode": "658119",
    "flow": {
      "currentStep": "SECOND_PRESENTATION_STARTED"
    },
    "rrn": "08032054026003400006298",
    "status": "SECOND_PRESENTATION_STARTED",
    "transactionId": "TI:bnMeLTGLm2Q7jllvf_Of6eHBL7Ef6KRkL-uNEUnhyV7Lgb8piMeU5altPIJpo5DKzBzC3ZGZ-1JVkUmA2a4FGkRm4gpibshDMuDAKk6jb6M=##ACQ",
    "isOpen": true,
    "partnerId": "01HPWX95S4ZNNKPMNKPDKE2E12",
    "acquirerId": "032314",
    "issuerId": "017670",
    "seen": false,
    "events": [
      {
        "name": "CREATED",
        "timestamp": "2024-03-05T19:51:58.202Z"
      },
      {
        "name": "SECOND_PRESENTATION_STARTED",
        "timestamp": "2024-03-05T19:51:58.202Z"
      }
    ],
    "createdAt": "2024-03-05T19:51:58.202Z",
    "updatedAt": "2024-03-05T19:54:01.709Z",
    "amount": 111916.69,
    "currency": "ARS",
    "merchant": {
      "storeId": "9b7396a2-9e60-4bd0-b2f6-5c4f911167b1",
      "ownerId": "2c671a9d-5d66-413e-88b2-aca5c3b6219d",
      "name": "Sip smart coffee",
      "mcc": "5921",
      "taxId": "30123452209",
      "taxIdType": "arg.cuit",
      "externalPaymentId": "05cfc7cd-6551-44d1-bf02-0d87a151046e",
      "contact": {
        "email": "No data",
        "phone": "No data",
        "businessName": "SIPECOFFEE SRL",
        "country": "ARG"
      },
      "address": {
        "country": "ARG",
        "address": {
          "number": "1130",
          "notes": "-",
          "street": "migueletes"
        },
        "city": "CIUDAD AUTONOMA BUENOS AIRES",
        "name": "Torre Galicia ok",
        "id": "35ba1a0c-fb37-41c5-a28d-9208adf4ad9c",
        "state": "C",
        "zip_code": "C1426BUP"
      }
    },
    "payment": {
      "data_privacy": {
        "encrypted": {
          "data": "x5tZYXEw0Cej9PHEENbigCoFe2wW+B2qXiVnHeWpu9nLcgMIldmAt708raupdppqwTBtrETeatwFPtZEAeh4z6ZPy/FPLGlZ9jWc35R2NH+ZtaOeuxTqPuR2oVcn6u8a7VA19hrbaRT2408b+bpeIfUkC0wrusqDMhVnn4pVrSnl08pyNYyXaDvYllifDE3R61+jzPbSzaVRKJ/C21IF15yIIm48a+D9Pdcxo10S7xNNyy/FjPD0q9u2VONBbruRURvT2RWey8zNMDpASYV/AClmRScyn/r/599kBWNoMnmbTZb08eSYz51eFAzhxq+7CpzRkmsW7o0QrSgLD+c4lg==",
          "origin": "non_present"
        }
      },
      "card_method_type": "encrypted",
      "card_holder_name": "Eze Calonge",
      "wallet_name": "galicia",
      "card_holder_doc_type": "DNI",
      "type": "card_payment",
      "expiration_date": "06/2028",
      "card_type": "CREDIT",
      "card_holder_email": "[email protected]",
      "expiration_year": "2028",
      "product_id": "MASTERCARD",
      "expiration_month": "06",
      "name": "MASTERCARD",
      "pan": "550568******6713",
      "card_holder_doc_number": "12345678",
      "QRName": "bb22707a-457e-4695-a29d-8ed76d4bbe85"
    }
  }
}

Authorizations

Authorization

string

header

required

API Token generated for your account. The token must be prefixed with Bearer.

Path Parameters

claimId

integer

required

Response

Successful response

success

boolean

Example:

true

data

object

Show child attributes

data.id

string

Unique identifier for the claim.

Example:

"207779219414"

data.primaryAccountNumber

string

Primary account number for the transaction.

Example:

"5450********6048"

data.rrn

string

Retrieval reference number for the transaction.

Example:

"08032054026003400006298"

data.status

enum<string>

The current status of the claim.

Available options:

PENDING_REVIEW,

COLLABORATION_ACCEPTED,

COLLABORATION_REJECTED,

SECOND_PRESENTATION_STARTED,

SECOND_PRESENTATION_COMPLETED,

SECOND_PRESENTATION_ACCEPTED,

COMPLETED

Example:

"SECOND_PRESENTATION_STARTED"

data.isOpen

boolean

Indicates if the claim is open or closed.

Example:

true

data.createdAt

string<date-time>

Date and time when the claim was created.

Example:

"2024-03-05T19:51:58.202Z"

data.updatedAt

string<date-time>

Date and time when the claim was last updated.

Example:

"2024-03-05T19:54:01.709Z"

data.merchantId

string

Unique identifier for the merchant.

Example:

"000000000010377"

data.amount

number

Example:

1000

data.currency

string

ISO 4217 currency code.

Example:

"ARS"

data.outcome

enum<string>

The current outcome. Indicates the current status of the claim. If the merchant won or lost the claim.

Available options:

in_progress,

won,

lost

Example:

"in_progress"

data.transactionId

string

Unique identifier for the transaction. For Mastercard, the transaction ID contains 2 parts separated by a #. The first part is the clearing transaction ID and the second part is the authorization transaction ID.

Example:

"TI:FIEaEgnM3bwPijwZgjc3Te+Y0ieLbN9ijUugqNSvJmVbO1xs6Jh5iIlmpOpkbax79L8Yj1rBOWBACx+Vj17rzvOepWobpgWNJNdsgHB4ag=#hqCnaMDqmto4wnL+BSUKSdzROqGJ7YELoKhEvluycwKNg3XTzSfaIJhFDkl9hW081B5tTqFFiAwCpcocPdB2My4t7DtSTk63VXDl1CySA8Y="

data.issuerId

string

Identifier for the issuer of the chargeback.

Example:

6195

data.acquirerId

string

Identifier for the acquirer of the chargeback.

Example:

6355

data.partnerId

string

Kausanna partner identifier.

Example:

"01HNBCE7RY395G62BCQFYDCV46"

data.seen

boolean

Indicates if the claim has been seen by the merchant / partner service.

Example:

false

data.events

object[]

Array of events related to the claim.

Show child attributes

data.events.name

string

Name of the event.

data.events.timestamp

string<date-time>

data.origin

string

The origin of the claim. Indicates if the claim was originated from Visa, Mastercard or other network.

Example:

"mastercard"

data.authCode

string

Authorization code for the transaction.

Example:

"ab3285c5"

data.flow

object

Show child attributes

data.flow.currentStep

string

The current step in the claim flow.

Example:

"PENDING_REVIEW"

data.payment

object

Contains all details about the payment method used.

Show child attributes

data.payment.id

string

The Ranty payment method identifier.

data.payment.data_privacy

object

Details about the privacy and encryption of payment data.

Show child attributes

data.payment.data_privacy.encrypted

object

Contains details about the data privacy and encryption.

Show child attributes

data.payment.data_privacy.encrypted.data

string

Encrypted data content.

Example:

"test"

data.payment.data_privacy.encrypted.origin

string

Origin of the data encryption.

Example:

"non_present"

data.payment.card_method_type

string

Type of card method used.

Example:

"encrypted"

data.payment.card_holder_name

string

Name of the card holder.

Example:

"Test"

data.payment.card_holder_doc_type

string

Type of document of the card holder.

Example:

"DNI"

data.payment.type

string

Type of payment.

Example:

"card_payment"

data.payment.expiration_date

string

Expiration date of the card.

Example:

"04/2029"

data.payment.card_type

string

Type of card used.

Example:

"DEBIT"

data.payment.card_holder_email

string

Email of the card holder.

Example:

"[email protected]"

data.payment.expiration_year

string

Expiration year of the card.

Example:

"2029"

data.payment.product_id

string

Product identifier.

Example:

"MASTERCARD"

data.payment.expiration_month

string

Expiration month of the card.

Example:

"04"

data.payment.name

string

Name of the payment product.

Example:

"MASTERCARD"

data.payment.pan

string

Partially masked PAN number.

Example:

"553771******3011"

data.payment.card_holder_doc_number

string

Document number of the card holder.

Example:

"002839234234"

data.payment.wallet_name

string

Name of the wallet used.

Example:

"galicia"

data.payment.QRName

string

QR name.

Example:

"bb22707a-457e-4695-a29d-8ed76d4bbe85"

data.merchant

object

Contains all the information related to a merchant, including payment and contact details.

Show child attributes

data.merchant.storeId

string

Unique identifier of the store.

Example:

"6546e6b2-b0ce-4159-addf-f0147ce08bc4"

data.merchant.ownerId

string

Unique identifier of the owner.

Example:

"c6efebfb-b5ba-4e17-8ece-c8c47d27ddf8"

data.merchant.name

string

Name of the merchant.

Example:

"Catdog"

data.merchant.mcc

string

Merchant category code.

Example:

"7311"

data.merchant.taxId

string

Tax identification number of the merchant.

Example:

"23395567659"

data.merchant.taxIdType

string

Type of tax identification number.

Example:

"arg.cuit"

data.merchant.externalPaymentId

string

External identifier for the payment.

Example:

"8524623"

data.merchant.contact

object

Contact details for the merchant.

Show child attributes

data.merchant.contact.email

string

Contact email address.

Example:

"No data"

data.merchant.contact.phone

string

Contact phone number.

Example:

"No data"

data.merchant.contact.businessName

string

Business name of the contact.

Example:

"EZEQUIEL CALONGE"

data.merchant.contact.country

string

Country of the contact.

Example:

"ARG"

data.merchant.address

object

Address details of the merchant.

Show child attributes

data.merchant.address.country

string

Country of the address.

Example:

"ARG"

data.merchant.address.address

object

Detailed street address.

Show child attributes

data.merchant.address.address.number

string

Street number of the address.

Example:

"135"

data.merchant.address.address.notes

string

Additional notes about the address.

Example:

"-"

data.merchant.address.address.street

string

Street name of the address.

Example:

"Luis piedra buena"

data.merchant.address.city

string

City of the address.

Example:

"CHIVILCOY"

data.merchant.address.name

string

Name associated with the address.

Example:

"LINK DE PAGO"

data.merchant.address.id

string

Identifier of the address.

Example:

"c231a73b-b1f5-4b1a-b049-675876938605"

data.merchant.address.state

string

State or province of the address.

Example:

"B"

data.merchant.address.zip_code

string

ZIP or postal code of the address.

Example:

"B6620AAA"

Introducción Buscar una disputa

⌘I

Documentación API

Claims

Documentación de claim

Webhooks

Utilidades

Authorizations

Path Parameters

Response