--- title: "Create Claim" method: POST path: "/pws/pws_mc_create_claim/" tags: ["Chargeback"] --- # Create Claim `POST /pws/pws_mc_create_claim/` This resource creates a new claim Issuers use this endpoint to create a new claim, which is required before creating a retrieval request or a first chargeback. If an issuer attempts to create a duplicate claim on an original transaction, the issuer receives a error message with the claim ID of the existing claim. Acquirers are not able to create claims. They receive claims from disputes that issuers initiate. Note: issuers must have a first presentment in order to create a claim. Note: issuers cannot create claims on first presentments that acquirers have reversed. ## Request body - McClaimModel - `api_call_unique_identifier` string, required — Unique number that must be passed at each API request. Identifier to make each API request unique - `authTransactionId` string, required — The Authorization Transaction Identifier from Authorization Summary Results. Valid Format : Alphanumeric Special character (~!@#$%^&*()_+{}|:"<>?,./;'[]-=) - `claimType` string, required — Claim tyoe Format : String Accepted value : Standard - `clearingTransactionId` string, required — The Clearing Transaction Identifier from Clearing Summary Results. Valid Format : Alphanumeric Special character (~!@#$%^&*()_+{}|:"<>?,./;'[]-=) - `client_id` integer, required — Unique identifier for the client which Paymentology will provide at outset - `disputedAmount` number, required — Amount disputed in the claim Format : Numeric - `disputedCurrency` string, required — Currency of amount disputed in the claim. disputedCurrency can be provided as standard alpha code or numeric code(must be three digit ISO-4217 standard numeric currency code) - `user_id` string — User Id of the Customer who triggered the API request. - `remarks` string — Remarks for API request - `referenceSetId` integer — Unique identifier for clearing summary (settlement). This field will be used if authorisation or clearing is internal Format : Numeric - `acquirerRefNumber` string — Acquirer Reference Number - `authorizationDateTime` string - `authenticationId` string — Authentication Id ## Response `200` Successful Response - McClaimResponseModel - `header` ResponseHeaderMCClaim - `error_id` integer — error id - `error_desc` string — error message - `body` ResponseBodyMCClaim - `acquirerId` string - `acquirerRefNum` string - `primaryAccountNum` string - `claimId` string - `claimType` string - `claimValue` string - `standardClaims` string - `clearingDueDate` string - `clearingNetwork` string - `createDate` string - `dueDate` string - `transactionId` string - `isAccurate` string - `isAcquirer` string - `isIssuer` string - `isOpen` string - `issuerId` string - `lastModifiedBy` string - `lastModifiedDate` string - `merchantId` string - `queueName` string - `switchSerialNumber` string - `caseFilingDetails` CaseFilingDetails - `caseFilingStatus` string - `caseFilingDetail` CaseFilingDetail - `claimId` string — claim id - `claimType` string — claim type - `caseId` string — case id - `caseType` string — case type - `chargebackRefNum` string[] — chargeback ref num - `currencyCode` string — currency code - `customerFilingNumber` string — customer filing number - `creditDate` string — credit date - `chargebackDate` string — chargeback date - `reasonCode` string — reason code - `disputeAmount` string — dispute amount - `dueDate` string — due date - `filingAgaintstIca` string — filing againtst Ica - `filingAs` string — filing as - `filingIca` string — filing Ica - `merchantName` string — merchant name - `primaryAccountNum` string — primary account num - `violationCode` string — violation code - `violationDate` string — violation date - `rulingDate` string — ruling date - `rulingStatus` string — ruling status - `virtualAccountNum` string — virtual account num - `caseFilingRespHistory` CaseFilingRespHistory[] - `memo` string — memo - `action` string — action - `responseDate` string — responseDate - `retrievalDetails` CommonRetrievalDetails - `acquirerRefNum` string - `acquirerResponseCd` string - `acquirerMemo` string - `acquirerResponseDt` string - `amount` string - `currency` string - `claimId` string - `createDate` string - `cancelDate` boolean - `reverseDate` boolean - `rejectDate` string - `docNeeded` string - `issuerResponseCd` string - `issuerRejectRsnCd` string - `issuerMemo` string - `issuerResponseDt` string - `imageReviewDecision` string - `imageReviewDt` string - `primaryAcctNum` string - `rejectReason` string - `requestId` string - `retrievalRequestReason` string - `chargebackRefNum` string - `acquirerResponseNotificationStatus` string - `instructionsForHealthcare` string - `refundReversalDate` string - `refundReversalAmount` string - `refundReversalCurrency` string - `refundReversalType` string - `refundReversalReferenceId` string - `memo` string - `chargebackDetails` ChargebackDetails[] - `currency` string — currency - `createDate` string — createDate - `documentIndicator` string — document indicator - `messageText` string — message text - `amount` string — amount - `reasonCode` string — document indicator - `isPartialChargeback` string — reason code - `chargebackType` string — chargeback type - `chargebackId` string — chargeback id - `claimId` string — claim id - `reversed` boolean — reversed - `reversal` boolean — reversal - `chargebackRefNum` string — document indicator - `documentStatus` string — chargeback ref num - `reconciliationAmount` string — reconciliation amount - `reconciliationCurrency` string — reconciliation currency - `rejectReason` string — reject reason - `editExclusionCode` string — edit exclusion code - `refundNotReceivedIndicator` string — refund not received indicator - `creditVoucherStatus` string — credit voucher status - `currencyConversionAssessmentCCAIncluded` string — currency conversion assessmentCCA included - `currencyConversionAssessmentCCAAmount` string — currency conversion assessmentCCA amount - `feeDetails` FeeDetails[] - `cardAcceptorIdCode` string — card acceptor id code - `cardNumber` string — card number - `countryCode` string — country code - `currency` string — currency - `feeDate` string — feeDate - `destinationMember` string — destination member - `feeId` string — fee id - `feeAmount` string — fee amount - `creditSender` boolean — credit sender - `creditReceiver` boolean — credit receiver - `message` string — message - `reason` string — reason - `rejectReason` string — reject reason - `reconciliationCurrency` string — reconciliation currency - `chargebackRefNum` string — chargeback ref num - `reconciliationAmount` string — reconciliation amount - `retrievalDetailsList` CommonRetrievalDetails[] - `acquirerRefNum` string - `acquirerResponseCd` string - `acquirerMemo` string - `acquirerResponseDt` string - `amount` string - `currency` string - `claimId` string - `createDate` string - `cancelDate` boolean - `reverseDate` boolean - `rejectDate` string - `docNeeded` string - `issuerResponseCd` string - `issuerRejectRsnCd` string - `issuerMemo` string - `issuerResponseDt` string - `imageReviewDecision` string - `imageReviewDt` string - `primaryAcctNum` string - `rejectReason` string - `requestId` string - `retrievalRequestReason` string - `chargebackRefNum` string - `acquirerResponseNotificationStatus` string - `instructionsForHealthcare` string - `refundReversalDate` string - `refundReversalAmount` string - `refundReversalCurrency` string - `refundReversalType` string - `refundReversalReferenceId` string - `memo` string ## 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)