---
title: "Request Chargeback"
method: POST
path: "/pws/v2/pws_mc_cb_request/"
tags: ["Chargeback V2"]
---

# Request Chargeback

`POST /pws/v2/pws_mc_cb_request/`

This resource creates a new chargeback

Issuers and acquirers use this endpoint to create chargeback and second presentments and optionally to upload supporting documents. Issuers and acquirers may use the parameters in the request to automatically generate the Expedited Billing Dispute Form (EBDF) and attach it to the claim.Request chargeback v2 supports idempotency

## Request body

- McCbRequestModel
  - `api_call_unique_identifier` string, required — Unique number that must be passed at each API request. Identifier to make each API request unique
  - `chargeBackType` string, required — <p> Chargeback type <ul> <li>CHARGEBACK - First chargeback</li> <li>ARB_CHARGEBACK - Second chargeback</li> </ul> </p>
  - `claimId` integer, required — Claim Id where the chargeback will be added
  - `client_id` integer, required — Unique identifier for the client which Paymentology will provide at outset
  - `currencyCcy` string, required — The chargeback currency. The data should be standard currency alpha code or numeric code
  - `disputedAmt` number, required — Amount of CB should be OT amount (DE4). US Issuers should always submit in USD. For more details refer to the GCMS Reference Manual.
  - `documentIndicator` boolean, required — Document Indicator defines if a document is required for the dispute.
  - `reasonCode` string, required — Chargeback Reason Code provides the chargeback receiver with the reason for sending the chargeback.
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request
  - `credPostedAsPurchase` string — Indicator to notify this is a credit posted as a purchase. Only applicable to reason codes of 4853 and 4860. Defaults to false.
  - `isPartialCb` boolean — Indicates a partial chargeback. Defaults to false.
  - `messageTxt` string — Member message text to be used for the chargeback.
  - `settlementDate` string — CONDITIONAL: Required for Argentina and Uruguay's Settlement Service participation ID codes (LA00003201, LA00003202, LA00085801, LA00085802, LA00084011, LA00084012). The date may not be prior to the current date or beyond 90 days from the current date.
  - `localTax1IVA` number — Applies only to LAC installments (Argentina and Uruguay). PDS 1015. Contains the VAT amount for the installment fee.
  - `installmentFee` number — Applies only to LAC installments (Argentina and Uruguay). PDS 1028. Contains the VAT amount for the installment fee.
  - `editExclusionCode` string — Edit exclusion code to bypass clearing system edits.
  - `refundNotReceivedIndicator` boolean — Cardholder/Issuer did not receive refund when a first chargeback was rejected by Collaboration with reason code 5000 indicating refund provided. 20 days after rejection of CB through collaboration. CONDITIONAL: this field is only applicable if chargebackType is CHARGEBACK.
  - `includeCurrencyConversionAssessmentCCA` boolean — Currency Conversion Assessment amount applied for full first chargeback, to indicate, if Currency Conversion Assessment was included or not for qualified transactions.
  - `token` integer — Public token. This is optional field and can be passed if settelemnt is internal
  - `acquirerRefNumber` string — Acquirer reference number. This is optional field and can be passed if settelemnt is internal
  - `authenticationId` string — Authentication Id. This is optional field and can be passed if settelemnt is internal
  - `fileName` string
  - `fileData` string
  - `acknowledgeFirstPartyTrustEvidence` boolean — Issuer has acknowledged First-Party Trust evidence and proceeded with the chargeback. Defaults to false. This field is not applicable to second presentments CONDITIONAL: This field is only applicable if chargebackType is CHARGEBACK.

## Response `200`

Successful Response

- McCbRequestResponse
  - `header` ResponseHeaderMCRequest
    - `error_id` integer — error id
    - `error_desc` string — error message
  - `body` ResponseBodyMCRequest
    - `fraudId` string — String[] reasonCodeArray = { "4837", "4840", "4849", "4863", "4870", "4871" }; If reasonCodeArray contains above then fraudId included else not.
    - `chargeBackId` string — chargeBack Id

## Other responses

- `404` — Webservices does not exist
- `500` — Internal Server error

---

[API](https://skmtc.net/paymentology/apis/payapi-docs.md) · [All operations](https://skmtc.net/paymentology/apis/payapi-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymentology/payapi-docs/revisions/a675891b0365/schema)