Buscar una disputa

Buscar un claim por parámetros

curl --request GET \
  --url https://e3-kausanna.sonqo.io/claims/search \
  --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

Buscar un claim por parámetros

curl --request GET \
  --url https://e3-kausanna.sonqo.io/claims/search \
  --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.

Query Parameters

transactionId

string

Identificador de la transacción. Este parámetro debe estar codificado para URL (encodeURIComponent)

authCode

string

Código de autorización

paymentId

string

Identificador del pago (de Ranty)

rrn

string

Número de referencia de recuperación

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"

Obtener reclamo por ID Listar reclamos por adquirente (acquirerId)

⌘I

Documentación API

Claims

Documentación de claim

Webhooks

Utilidades

Authorizations

Query Parameters

Response