Actualizar el estado

Este endpoint admite dos tipos de estado de reclamación: APPROVED y REJECTED. El estado de la reclamación se actualiza en función del tipo de estado que se envíe en el cuerpo de la solicitud. En el caso de que la reclamación se encuentre en la etapa de colaboración se aceptará o rechazará la colaboración en función del estado que se envíe en el cuerpo de la solicitud. Puedes ver más sobre los estados de un reclamo aquí.

Authorizations

Authorization

string

header

required

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

Path Parameters

claimId

integer

required

Body

application/json

status

enum<string>

Available options:

ACCEPTED,

REJECTED

Example:

"REJECTED"

Response

success

boolean

Indica si la operación fue exitosa

transitionedTo

string

El estado al que se ha cambiado la reclamación

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"

Documentación API

Claims

Documentación de claim

Webhooks

Utilidades

Authorizations

Path Parameters

Body

Response