Disputes

POST

{account_id}

disputes

curl --request POST \
  --url https://api.nest.pagosapi.com/v1/{account_id}/disputes \
  --header 'Content-Type: application/json' \
  --data '{
  "dispute_id": "<string>",
  "amount": 1,
  "amount_refunded": 1,
  "currency": "<string>",
  "created": "<string>",
  "transaction_id": "<string>",
  "transaction_order_id": "<string>",
  "payment_method_details": {
    "payment_method_type": "<string>",
    "card": {
      "attributes": {
        "network": "<string>",
        "type": "<string>",
        "bin": "<string>",
        "issuer_bank": "<string>",
        "issuer_country": "<string>"
      }
    }
  },
  "dispute_response": {
    "status": "<string>",
    "reason_code": "<string>",
    "reason": "<string>"
  },
  "additional_data": {
    "merchant_account_id": "<string>",
    "order_id": "<string>",
    "acquirer_reference_number": "<string>",
    "metadata": {}
  },
  "pagos_codes": {
    "pagos_dispute_status": "case_closed",
    "pagos_dispute_reason": "ACCOUNT_TAKE_OVER"
  }
}'

Path Parameters

account_id

string

required

Body

application/json

dispute_id

string

required

A unique value that identifies the dispute and will be used as the key when making updates to disputes. Maximum 255 characters.

Required string length: 1 - 255

amount

integer

required

The dispute amount, represented as a positive integer in the smallest currency unit (e.g. two-decimal currency such as $101.50 is represented as 10150, zero-decimal currency such as ¥1095 is represented as 1095). Refer to the ISO 4217 currency page for guidance.

Required range: x > 0

currency

string

required

The currency of the dispute, represented by the 3-letter ISO-4217 currency code. Must be three characters.

Required string length: 3

created

string

required

The date when the dispute was created, represented in ISO 8601 format (e.g. 2023-09-04T16:13:05Z).

transaction_id

string

required

The transaction ID of the original transaction associated with the dispute. Maximum 255 characters.

Maximum length: 255

payment_method_details

object

required

pagos_codes

object

required

pagos_codes.pagos_dispute_status

enum<string>

required

Assign a Pagos chargeback status code that corresponds to dispute_response.status.

Available options:

case_closed,

chargeback_cancelled,

dispute_accepted,

dispute_charge_refunded,

dispute_evidence_sent,

dispute_expired,

dispute_lost,

dispute_open,

dispute_reversal,

dispute_won,

dispute_won_partial,

eligible_for_appeal,

no_value_provided,

notification_of_chargeback_open,

notification_of_chargeback_undefended,

notification_of_fraud,

pre_arbitration_accepted,

pre_arbitration_expired,

pre_arbitration_lost,

pre_arbitration_requested,

pre_arbitration_won,

rfi_accepted,

rfi_closed,

rfi_evidence_sent,

rfi_expired,

rfi_open,

second_cb_lost,

unknown,

unknown_status_chargebackExternally,

unreadable_value,

waiting_for_response

pagos_codes.pagos_dispute_reason

enum<string> | null

Assign a Pagos chargeback reason code that corresponds to reason or reason_code. Required when reason or reason_code contains a value.

Available options:

ACCOUNT_TAKE_OVER,

CANCELLED_RECURRING_OR_SERVICE,

CARD_ISSUED_ON_FRAUDLENT_APPLICATION,

CARD_NOT_PRESENT,

CHARGEBACK_REVERSED,

CHIP_LIABILITY_SHIFT,

COUNTERFEIT_FRAUD,

CREDIT_NOT_PROCESSED,

DECLINED_AUTHORIZATION,

DISPUTE_ADJUSTMENT,

DUPLICATE_PROCESSING,

EXPIRED_CARD,

Exception_Processing,

FRAUD_AUTO_DEFENDED,

FRAUD_GENERIC,

FRAUD_MONITORING_PROGRAM,

FRAUD_PROGRAM,

GENERIC_CUSTOMER_DISPUTE,

GOOD_FAITH_INVESTIGATION,

HIGH_RISK_ORDER,

INCORRECT_AMOUNT,

INCORRECT_CURRENCY,

INCORRECT_INVOICE,

INCORRECT_PROCESSING,

INSUFFICIENT_FUNDS,

INVALID_ACCOUNT,

INVALID_DATA,

LATE_PRESENTMENT,

LOST_CARD_FRAUD,

MERCHANDISE_DAMAGED,

MERCHANDISE_NOT_AS_DESCRIBED,

MERCHANDISE_OR_SERVICES_NOT_RECEIVED,

MERCHANDISE_RETURNED,

MISCELLANEOUS,

NO_AUTHORIZATION_OBTAINED,

NO_IMPRINT,

NO_REPLY,

NO_SHOW,

NO_SIGNATURE,

PAID_BY_OTHER_MEANS,

Processing_Error,

QUESTIONABLE_CLIENT_ACTIVITY,

RFI,

Rejects,

Reversals,

SEPA_DISPUTE,

STOLEN_CARD_FRAUD,

UNAUTHORIZED_UNRECOGNIZED,

Unknown,

atm_dispute,

no_value_provided,

reason_not_available,

unreadable_value,

violation

amount_refunded

integer | null

The amount refunded to the customer, represented as a positive integer in the smallest currency unit (e.g. two-decimal currency such as $101.50 is represented as 10150, zero-decimal currency such as ¥1095 is represented as 1095). The value is unsigned. Refer to the ISO 4217 currency page for guidance.

Required range: x > 0

transaction_order_id

string | null

The merchant order reference of the original transaction associated with the dispute. Maximum 255 characters.

Maximum length: 255

dispute_response

object | null

additional_data

object | null

Refunds Disbursements

curl --request POST \
  --url https://api.nest.pagosapi.com/v1/{account_id}/disputes \
  --header 'Content-Type: application/json' \
  --data '{
  "dispute_id": "<string>",
  "amount": 1,
  "amount_refunded": 1,
  "currency": "<string>",
  "created": "<string>",
  "transaction_id": "<string>",
  "transaction_order_id": "<string>",
  "payment_method_details": {
    "payment_method_type": "<string>",
    "card": {
      "attributes": {
        "network": "<string>",
        "type": "<string>",
        "bin": "<string>",
        "issuer_bank": "<string>",
        "issuer_country": "<string>"
      }
    }
  },
  "dispute_response": {
    "status": "<string>",
    "reason_code": "<string>",
    "reason": "<string>"
  },
  "additional_data": {
    "merchant_account_id": "<string>",
    "order_id": "<string>",
    "acquirer_reference_number": "<string>",
    "metadata": {}
  },
  "pagos_codes": {
    "pagos_dispute_status": "case_closed",
    "pagos_dispute_reason": "ACCOUNT_TAKE_OVER"
  }
}'

Data & Response Codes

Data Ingestion

BIN Database

Account Updater

Toucan Tokenization

Path Parameters

Body