--- title: "Get dispute" method: GET path: "/v1/disputes/{disputeId}" tags: ["Disputes"] --- # Get dispute `GET /v1/disputes/{disputeId}` Get information about a specific dispute given its ID in the path. You can use the [List disputes](https://developers.pismo.io/pismo-docs/reference/get-v1-disputes) endpoint to get dispute IDs. ## Path parameters - `disputeId` number, required ## Response `200` OK - object - `id` number — Dispute ID - `org_id` string — Organization ID - `account_id` integer — Account ID - `authorization_id` integer — Authorization ID. - `disputed_amount` number — Disputed amount. - `comment` string, nullable — Client custom dispute comment. **REQUIRED** for Visa partial dispute to explain why partial. - `airport_tax` boolean — For ELO card network, should dispute for airport tax be created? Default is `true` for ELO. - `airport_tax_partial` boolean — For ELO card network, should airport tax be partially disputed? Default is `false`. - `airport_tax_amount` number — Airport tax amount to be disputed. **REQUIRED** if `airport_tax_partial` is `true`. - `dispute_reason` number — Each card network, such as Visa or Mastercard, defines and maintains their own unique set of reason codes, which banks that issue credit and debit cards under their brands apply to disputes. Here's a reason code [quick reference](https://www.chargebackgurus.com/blog/a-definitive-guide-to-chargeback-reason-codes-by-card-network#chargback-reason-code-quick-reference-guide) for the major credit card networks. For Visa, this would be either `10` (fraud - card present), `11` (authorization), `12` (processing error), or `13` (consumer dispute). For more infomation, refer to the [Visa](https://usa.visa.com/dam/VCOM/global/support-legal/documents/chargeback-management-guidelines-for-visa-merchants-vbs-19-may-16-%20v2.pdf) or [Mastercard](https://www.mastercard.us/content/dam/public/mastercardcom/na/global-site/documents/chargeback-guide.pdf) chargeback quides. For example - `4853` (Mastercard - cardholder dispute), `12` (Visa - processing error) or `72` (ELO - denied authorization) - `modality` number — Dispute *modality* - legacy term for reason code to file the dispute. - `dispute_status` 'OPENED' | 'PENDING' | 'CANCELED' | 'FAILED' | 'CHARGEBACK_REJECTED' | 'CHARGEBACK_CREATED' | 'CHARGEBACK_ACCEPTED' | 'CHARGEBACK_CLOSED' | 'SECOND_PRESENTMENT' | 'PRE_ARBITRATION_OPENED' | 'PRE_ARBITRATION_ACCEPTED' | 'PRE_ARBITRATION_DECLINED' | 'PRE_ARBITRATION_RECALL' | 'PRE_ARB_ALLOCATION_OPENED' | 'FAILED_PRE_ARBITRATION' | 'PRE_ARB_ALLOCATION_ACCEPTED' | 'PRE_ARB_ALLOCATION_DECLINED' | 'PRE_ARB_ALLOCATION_RECALLED' | 'FAILED_DECLINE_PRE_ARB' | 'FAILED_ACCEPT_PRE_ARB' | 'FAILED_ON_CLOSE' | 'EXPIRED' | 'ISSUER_LOSS' | 'MIGRATION' | 'FAILED_MIGRATION' — Dispute status enums. - `dispute_group_status` 'OPEN' | 'APPROVED' | 'DENIED' | 'CARDNETWORK_CHARGEBACK' | 'ANALYSING' | 'CARDNETWORK_SECOND_PRESENTMENT' | 'FAILED' | 'CARDNETWORK_PREARBITRATION' | 'RESEND' | 'LOSS' | 'WON' | 'REJECTED' | 'FAILED_PROCESSED' — Group status enums - `timeline` string — Client custom timeline information. - `protocol` string — Client custom protocol ID. This is primarily for you to internally identify a request. If not provided, Pismo creates a CID (correlation ID) field for this purpose. - `metadata` string — Any data object with key/value pairs. No limit on length. **Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis#metadata). - `created_at` string, date-time — Datetime program calendar strategy was created. Format = YYYY-MM-DDTHH:MM:SS:MM. - `updated_at` string, date — Dispute last updated date, format = yyyy-mm-dd. - `created_at_utc` string, date-time — Dispute created in UTC date/time. - `updated_at_utc` string — When dispute updated in UTC date/time. - `is_network` boolean — Open a dispute over a network authorization. - `is_dispute_migrated` boolean — Has this dispute been migrated to the Pismo platform? - `reversal_id` number — Dispute credit reversal ID. - `network_return_reason_code` string — Network reason code response. - `network_brand_type` 'Visa' | 'Mastercard' | 'Elo' — Network brand - `transaction_date` string — Transaction date related to authorization, format = yyyy-mm-dd - `stop_automated_installment` boolean — Automated dispute installment control flag. If an issuer opens a dispute for a transaction that has more than one installment, with installments that can still be posted, the issuer will need to open a dispute for subsequent installments as well. With automated dispute installment control, once you open a chargeback for the first installment, the same information can be used for subsequent transaction installments. - `card_hash` string — Card number hash. - `authorization_code` string — Authorization code - `transaction_amount` number — Transaction amount - `is_dispute_invalid_transaction` boolean — Is this an invalid authorization dispute? - `dispute_installments` DisputeInstallment[] - `id` number — Dispute installment ID. - `dispute_id` number — Dispute ID - `installment` integer — Installment number. - `arn` string — Installment acquirer reference number. - `chargeback_id` string, nullable — Network chargeback ID. - `claim_id` string, nullable — Network claim ID. - `installment_disputed_amount` number — Installment disputed amount. - `network_return_reason_code` string, nullable — Network returned reason code. - `networkStatus` string — Dispute status from the network - `reason_code` number — Each card network, such as Visa or Mastercard, defines and maintains their own unique set of reason codes, which banks that issue credit and debit cards under their brands apply to disputes. Here's a reason code [quick reference](https://www.chargebackgurus.com/blog/a-definitive-guide-to-chargeback-reason-codes-by-card-network#chargback-reason-code-quick-reference-guide) for the major credit card networks. For Visa, this would be either `10` (fraud - card present), `11` (authorization), `12` (processing error), or `13` (consumer dispute). For more infomation, refer to the [Visa](https://usa.visa.com/dam/VCOM/global/support-legal/documents/chargeback-management-guidelines-for-visa-merchants-vbs-19-may-16-%20v2.pdf) or [Mastercard](https://www.mastercard.us/content/dam/public/mastercardcom/na/global-site/documents/chargeback-guide.pdf) chargeback quides. For example - `4853` (Mastercard - cardholder dispute), `12` (Visa - processing error) or `72` (ELO - denied authorization) - `network_return_reject_reason` string, nullable — Formated network reject reason information. - `network_response_error` string, nullable — Network response error. - `dispute_status` DisputeStatusObject — Dispute status informations. - `id` number — Dispute status ID. - `description` string — Description status - enums for a client's state machine, not to be implemented for anyone else at this point. - `type` 'PRIMITIVE_ON_US' — Type status ID. - `group` 'OPEN' | 'APPROVED' | 'DENIED' | 'CARDNETWORK_CHARGEBACK' | 'ANALYSING' | 'CARDNETWORK_SECOND_PRESENTMENT' | 'FAILED' | 'CARDNETWORK_PREARBITRATION' | 'RESEND' | 'LOSS' | 'WON' | 'REJECTED' | 'FAILED_PROCESSED' — Group status enums - `network_response` object, nullable — Network response information - `id` number — Network response ID. - `dispute_id` number — Dispute ID - `dispute_installment_id` integer — Dispute installment ID. - `claim_id` string — Network claim ID. - `chargeback_id` string — Network chargeback ID. - `reason_code` number — Each card network, such as Visa or Mastercard, defines and maintains their own unique set of reason codes, which banks that issue credit and debit cards under their brands apply to disputes. Here's a reason code [quick reference](https://www.chargebackgurus.com/blog/a-definitive-guide-to-chargeback-reason-codes-by-card-network#chargback-reason-code-quick-reference-guide) for the major credit card networks. For Visa, this would be either `10` (fraud - card present), `11` (authorization), `12` (processing error), or `13` (consumer dispute). For more infomation, refer to the [Visa](https://usa.visa.com/dam/VCOM/global/support-legal/documents/chargeback-management-guidelines-for-visa-merchants-vbs-19-may-16-%20v2.pdf) or [Mastercard](https://www.mastercard.us/content/dam/public/mastercardcom/na/global-site/documents/chargeback-guide.pdf) chargeback quides. For example - `4853` (Mastercard - cardholder dispute), `12` (Visa - processing error) or `72` (ELO - denied authorization) - `response_error` string — Network response error. - `reject_reason` string — Network reject reason information. - `transaction_id` string, nullable — Transaction ID. - `dispute_form_list` DisputeFormResponse[] - `id` number — Dispute form ID. - `dispute_installment_id` number, nullable — If necessary to join Form to Installment. If not passed, first installment is used. - `status` 'PENDING' | 'PROCESSED' | 'FAILED' | 'INACTIVE' — Dispute form status. - `network` 'MASTERCARD_CARD' | 'PRIMITIVE' — Network for dispute Form. - `form` object - `ebdf` object - `fraudDrfDocument` FraudDrfDocumentStructure - `numberOfItems` string — Number of transactions being disputed as string. - `types` 'CARD_CLOSED' | 'REPORT_SAFE' | 'CAPTURE_CARD' | 'LOST_STOLEN' | 'COUNTERFEIT' | 'RC_4837' | 'RC_4840' — Enter any of the valid values comma separated. Valid Values/Format: `CARD_CLOSED`, `REPORT_SAFE`, `CAPTURE_CARD`, `LOST_STOLEN`, `COUNTERFEIT`, `RC_4837`, `RC_4840` `RC_4837` = Reason code 4837 (Mastercard - fraud) `RC_4840` = Reason code 4840 (Mastercard - fraudelent processing of transaction) - `additionalInformation` string — Additional information, if needed, 1000 chars max. Valid Values/Format: Alphanumeric / Special Char (~!@#$%^&*()_+{}|:"<>?,./;'[]-=) - `chargebackRepresentative` string — Customer Service/Chargeback Representative Valid Values/Format: Alphanumeric / Special Char (~!@#$%^&*()_+{}|:"<>?,./;'[]-=) - `cardIssuerRegion` 'AP' | 'Europe' | 'NAM' | 'LAC' | 'MEA' — Card issuer region. Valid Values:
`AP` - Asian Pacific
`Europe` - Europe
`NAM` - North America
`LAC` - Latin America and Caribbean
`MEA` - Middle East and Africa - `cardholderVerificationMethod` CardholderVerificationMethodStructure - … - `cardholderDisputeChargebackDrfDocument` CardholderDisputeChargebackDrfDocumentStructure - `transactionAmount` string — Transaction amount. Length: 0-12 Valid Values/Format: Numeric - `type` 'PRODUCT_DISPUTE' | 'NOT_PROVIDED' | 'DIGITAL_GOODS' | 'CREDIT_NOT_PROCESSED' | 'COUNTERFEIT' | 'RECURRING_CANCELLED' | 'RECURRING_DISCLOSURE' | 'ADDENDUM_DISPUTE' | 'HOTEL_NO_SHOW' | 'PURCHASE_INCOMPLETE' | 'CANCELLATION_AGREEMENT' | 'POSTED_CREDIT' | 'FAILED_TRAVEL' — Cardholder dispute type. - `deliveryDateOfGoodsOrServices` string — In case of `PRODUCT_DISPUTE`, goods or services delivery date. Format = dd-MMM-yyyy - `expectedDeliveryDateOfGoodOrServices` string — In case of `NOT_PROVIDED`, goods or services expected delivery date. Format = dd-MMM-yyyy - `returnDate` string — In case of `DIGITAL_GOODS`, return or cancellation of the goods or services. Format = dd-MMM-yyyy - `cancellationDate` string — In case of `RECURRING_CANCELLED`, cancellation of the goods or services. Format = dd-MMM-yyyy - `cardholderParticipation` boolean — Did the cardholder participate in the transaction? - `disputeDetails` string — Describe the cardholder’s complaint in sufficient detail to meet the requirements for the chargeback as described in the Chargeback Guide and to enable all parties to understand the dispute. Valid Values/Format: Alphanumeric / Special Char (~!@#$%^&*()_+{}|:"<>?,./;'[]-=) - `chargebackRepresentative` string — Customer service/chargeback representative. Valid Values/Format: Alphanumeric / Special Char (~!@#$%^&*()_+{}|:"<>?,./;'[]-=) - `pointOfInteractionErrorsDrfDocument` PointOfInteractionErrorsDrfDocumentStructure - `transactionAmount` string — The transaction amount as string. - `type` 'DUPLICATE_DEBIT' | 'INCORRECT_AMOUNT' | 'LTD_TRANSACTION' | 'CURRENCY_DISPUTE' | 'UNREASONABLE_AMOUNT' | 'DUPLICATE_TRANSACTION' | 'MERCHANT_CREDIT' | 'IMPROPER_MERCHANT_SURCHARGE' — Error type enum, i.e. `DUPLICATE_DEBIT` - `alternateMeansOfPaymentDetails` string — In case of `DUPLICATE_DEBIT`, Alternate means of payment details. Max length = 55 chars. Valid Values/Format: Alphanumeric / Special Char (~!@#$%^&*()_+{}|:"<>?,./;'[]-=) - `disputeDetails` string — Describe the cardholder's complaint in sufficient detail to meet the requirements for the chargeback as described in the Chargeback Guide and to enable all parties to understand the dispute. Valid Values/Format: Alphanumeric / Special Char (~!@#$%^&*()_+{}|:"<>?,./;'[]-=) - `chargebackRepresentative` string — Customer service/chargeback representative. Valid Values/Format: Alphanumeric / Special Char (~!@#$%^&*()_+{}|:"<>?,./;'[]-=) - `allocationQuestionnaire` VisaAllocationQuestionnaireDocumentStructure - `accountStatus` 'AC' | 'CP' | 'F', required — Valid in VISA Authorization Flux (reason code 11).
`AC` = Account closed
`CP` = Credit problem
`F` = Fraud
- `oneAuthForMultipleSalesInd` 'Y' | 'N' — Valid in VISA Authorization Flux (reason code 11). - `collaborationQuestionnaire` VisaCollaborationQuestionnaireDocumentStructure - `incorrectCurrencyReason` 'CD' | 'DD' — Valid in VISA Processing Errors Flux (reason code 12.3). - `authorizationRequestDeclinedValidDataInd` boolean — Valid in VISA Processing Errors Flux (reason code 12). - `explainWhyValidDataInclusionReason` string — Valid in VISA Processing Errors Flux (reason code 12). - `correctCurrency` integer — Valid in VISA Processing Errors Flux (reason code 12). - `cardholderDidNotAgreeDCC` 'Y' | 'N' — Valid in VISA Processing Errors Flux (reason code 12). - `transactionCodeIncorrect` 'CRI' | 'CRD' | 'DCR' — Valid in VISA Processing Errors Flux (reason code 12). - `rolTransactionId` number — Valid in VISA Processing Errors Flux (reason code 12). - `incorrectTransactionId` string — Valid in VISA Processing Errors Flux (reason code 12). - `explainWhyCreditRefundProcessedInError` string — Valid in VISA Processing Errors Flux (reason code 12). - `issuerMasterFileAccountNumberInd` 'Y' | 'N' — Valid in VISA Processing Errors Flux (reason code 12). - `receiptAccountNumberMatchInd` 'Y' | 'N' — Valid in VISA Processing Errors Flux (reason code 12). - `cardholderReceiptAmt` number — Valid in VISA Processing Errors Flux (reason code 12). - `merchantDisputePriceDiffInd` 'Y' | 'N' — Valid in VISA Processing Errors Flux (reason code 12). - `bothTransactionsOnSameAcctNumberInd` 'Y' | 'N' — Valid in VISA Processing Errors Flux (reason code 12). - `duplicateTranId` string — Valid in VISA Processing Errors Flux (reason code 12). - `issuerOrCardholderOtherAcctWithDiffVisaCardInd` 'Y' | 'N' — Valid in VISA Processing Errors Flux (reason code 12). - `issuerEvidenceMerchantPassedOnFundsInd` 'Y' | 'N' — Valid in VISA Processing Errors Flux (reason code 12). - `cardholderAttemptToResolve` 'Y' | 'N' — Valid in VISA Processing Errors Flux (reason code 12 and 13). - `attemptToResolveProhLocalLaw` 'Y' | 'N' — Valid in VISA Processing Errors Flux (reason code 12 and 13). - `otherTranSameMerchantInd` 'Y' | 'N' — Valid in VISA Processing Errors Flux (reason code 12). - `providingPaymentProofOtherMeans` 'A' | 'T' | 'C' | 'F' | 'V' | 'S' | 'O' — Valid in VISA Processing Errors Flux (reason code 12). - `arn` string — Valid in VISA Processing Errors Flux (reason code 12). - `transactionID` string — Valid in VISA Processing Errors Flux (reason code 12). - `merchantFacilitiesWithdrawn` boolean — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `cardholderDeceased` boolean — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `cancellationDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `contactMethodWithMerchantInd` boolean — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `contactMethodMerchantEmailInd` boolean — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `contactMethodMerchantCallCenterInd` boolean — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `contactMethodMerchantMailInd` boolean — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `contactMethodMerchantSMSInd` boolean — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `contactMethodMerchantInPersonInd` boolean — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `contactMethodMerchantWebformInd` boolean — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `contactMerchantDetailsPhoneNumber` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `contactMerchantDetailsEmailAddress` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `contactMerchantDetailsPhysicalAddress` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `contactMerchantDetailsApplicationName` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `otherFormOfPaymentInd` boolean — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `otherFormOfPaymentDesc` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `accountClosureDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `cancellationMethod` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `disputeRelateToOffpremisesDistanceSellInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `disputeRelateToInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `contractDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `merchandiseOrServices` 'Merchandise' | 'Services' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `serviceType` 'T' | 'G' | 'O' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `whatWasPurchased` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `cardholderReceiveMerchandiseInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `chReceivedOrExpectedMerchandise` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `cardholderReturnMerchandiseInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `cardholderReturnedMerchandiseDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `returnedMerchandiseReceivedDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `returnMethod` 'FF' | 'FE' | 'D' | 'U' | 'P' | 'O' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `howMerchandiseReturned` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `shippingTrackingNumber` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `cardholderAttemptReturnMerchandise` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `attemptedReturnDate` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `howChAttemptReturnAndDispOfMerchandise` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `merchantRefuseAdvise` 'MRRM' | 'MICNRM' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `didCardholderCancel` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `didCardholderCancelBeforeShipping` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `timeshareDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `dateOfService` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `certificationGuaranteedReservation` 'GR' | 'RC' | 'AR' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `cancellationPolicyProvidedInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `whatWasOrdered` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `merchandiseWasCounterfeitDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `descCounterfeitMerchandise` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `descDispOfCounterfeitMerchandise` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `originalCreditNotAccepted` 'R' | 'O' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `explain` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `creditVoucherTransactionReceiptDated` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `creditVoucherOrTransactionReceiptDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `cardholderCancelledReturnedMerchDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `merchantInLiquidationOrReceivershipInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `whatWasNotReceived` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `thirdPartyGiftCardInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `visaComCardVirtualAccInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `virtualAccFinancialLossInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `didMerchantCancelInd` 'Y' | 'N' — alid in VISA Consumer Disputes Flux (Reason Code 13). - `merchantCancellationDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `nonReceiptOfTravelServicesInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `disputeInvolveBondingAuthorityInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `explainAttemptToResolveWithBondAuth` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `bondAuthLetterOrAdviceDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `purchasedInfo` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `expectedReceiptDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `expectedReceiptTime` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `explainDisputePriorDeliveryDate` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `didCardholderCancelPriorExpectedDate` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `merchandiseDeliveredWrongLocation` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `lateDeliveryWrongLocation` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `didMerchantCancelMerchandiseInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `merchantCancelMerchandiseDate` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `merchandiseReceivedDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `cardholderMerchantPreviousNegotiationEvidence` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `whenNegotiationsBegin` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `explainPrevNegotiation` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `cardholderFirstNotifiedIssuerDisputeDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `serviceReceivedDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `howMerchandiseOrServiceMisrepresented` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `merchandiseServiceReceivedDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `explainPreNegotiation` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `orderDetailsNotAsDescribed` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `merchantReceivedReturnedMerchandiseDate` string, date — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `merchantAcceptCancellationInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `qualityOfFoodInd` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `purchasedInfoAndQualityIssue` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `didCardholderPayWorkRedone` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `howTermsOfContractNotHonoredByMerchant` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `nonFiatCurrencyNotDelivered` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `merchandiseDeliveredLate` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `merchantInBankruptcyLiquidationInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `nonFiatCurrencyNotMatching` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `dispositionOfMerchandise` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `merchantAcceptInd` 'Y' | 'N' — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `explainCreditIssuedLateDetailsOfNegotiations` string — Valid in VISA Consumer Disputes Flux (Reason Code 13). - `preArbitration` PreArbitration - `preArbReason` string, required — Pre-arbitartion reason - `newInformationInd` 'Y' | 'N' — New information - `Y` or `N` - `newInformationDescription` string — New information description - `issuerCertifiesCardholderContactedInd` 'Y' | 'N' — Issuer certifies cardholder contact - `created_at` string, date-time — Datetime program calendar strategy was created. Format = YYYY-MM-DDTHH:MM:SS:MM. - `created_at_utc` string, date-time — Dispute created in UTC date/time. - `update_at` string, date — Update date, format = yyyy-mm-dd - `update_at_utc` string, date-time — Update UTC date - `dispute_form_type` DisputeFormType - `dispute_form_type_id` number — Unique id identification - `type` string — Unique type identification - `description` string — Generic description - `dispute_fraud_report` DisputeFraudReportDto — Response to a dispute fraud report. - `fraud_report_id` number — Dispute fraud report ID. - `status` 'PENDING' | 'PROCESSED' | 'FAILED' | 'INACTIVE' — Dispute form status. - `network_brand_type` 'Visa' | 'Mastercard' | 'Elo' — Network brand - `report` DisputeFraudReportDocumentStructure - `acct_status` 'ACCT_IS_OPEN' | 'ACCT_HAS_BEEN_CLOSED', required — Account status - `chgbk_indicator` '0' | '1', required — Is this a chargeback? true = `1`, false = `0`. - `cvc_invalid_indicator` 'Y' | '*' | 'M' | 'N' | 'P' | 'U' | '?' | 'E', required — Mastercard CVC invalid code indicator - `device_type` '1' | '2' | '3' | '4' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J', required — Mastercard account device type. - `fraud_type` '00' | '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '10' | '11' | '51' | '55' | '56' | '57', required — Mastercard fraud type codes - `report_date` string, required — Fraud report date, format = yyyy-mm-dd. - `sub_type` 'K' | 'N' | 'P' | 'U', required — Mastercard fraud sub type codes - `authorization_origin_indicator` 'Y' | 'X' | 'N', nullable — Authorization origin indicator, default is null. **REQUIRED** for ELO network.
`Y` - Issuer authorized
`X` - Parameter authorized
`N` - Not Authorized
- `notification_code` '1' | '2' | '3' | '4' | '5', nullable — Notification type code. Default is null. **REQUIRED** for ELO network.
`1` - First notification
`2` - Notification sent again
`3` - Change
`4` - Deletion (cancellation fraud warning)
`5` = Reactivation
- `exchange_indicator` 'N' | 'Y' — Is this an exchange? Default is `N`. **REQUIRED** for ELO network.
`Y` - Yes
`N` - No
- `exchange_value` number — Exchange value. **REQUIRED** for ELO network. - `card_service_code` 'C' | 'M' — Card type. **REQUIRED** for ELO network.
`C` - Chip
`M` - Stripe
- `fraud_report_network_id` number — Fraud report network identifier. - `comment_network` string — Fraud Report comment network. - `created_at` string, date-time — Datetime program calendar strategy was created. Format = YYYY-MM-DDTHH:MM:SS:MM. - `updated_at` string, date-time — Datetime program calendar strategy was updated. Format = YYYY-MM-DDTHH:MM:SS:MM - `pre_arbitration` PreArbitrationDto — Information when dispute is submitted to Pre-Arbitration and case was created. - `pre_arbitration_response_id` number — Case ID created from Mastercom. - `memo` string — Enter a memo pertaining to the case. - `updated_chargeback_reason_code` number — Each card network, such as Visa or Mastercard, defines and maintains their own unique set of reason codes, which banks that issue credit and debit cards under their brands apply to disputes. Here's a reason code [quick reference](https://www.chargebackgurus.com/blog/a-definitive-guide-to-chargeback-reason-codes-by-card-network#chargback-reason-code-quick-reference-guide) for the major credit card networks. For Visa, this would be either `10` (fraud - card present), `11` (authorization), `12` (processing error), or `13` (consumer dispute). For more infomation, refer to the [Visa](https://usa.visa.com/dam/VCOM/global/support-legal/documents/chargeback-management-guidelines-for-visa-merchants-vbs-19-may-16-%20v2.pdf) or [Mastercard](https://www.mastercard.us/content/dam/public/mastercardcom/na/global-site/documents/chargeback-guide.pdf) chargeback quides. For example - `4853` (Mastercard - cardholder dispute), `12` (Visa - processing error) or `72` (ELO - denied authorization) - `merchant_name` string — Merchant name. - `acquiring_institution_code` string — Acquiring institution code. - `change_reason_code_reason` string — Change reason code reason. - `case_network_response` string — Updates response from Mastecom about the case. - `justify_not_accepted_fully` string — Justify why not accepted fully - `is_partial` boolean — Is partial amount chargeback? Default is `false`. - `currency_code_request` string — ISO 4217 3-letter currency code request. - `currency_code_response` string — ISO 4217 3-letter currency code, For example, `986` = Brazilian real and `840` = US dollar. - `amount_request` number — Request amount - `amount_response` number — Response amount - `acquirer_memo` string — Memo from the acquirer included in the Mastercard pre-arbitration rejection response. - `action` 'ACCEPT' | 'REJECT' | 'REBUT' | 'ESCALATE' | 'WITHDRAW' | 'FAVORSENDER' | 'FAVORRECEIVER' | 'DECLINED' | 'MODIFYCASE' | 'CREATECASE' | 'EXPIRED' — Network pre-arbitration action. - `response_date` string — Date of the network's pre-arbitration response. Format = yyyy-mm-dd - `dispute_due_to` 'NR' | 'CR' | 'ND' | 'DM' | 'Q' | 'CM' | 'M' | 'CN' | 'CS' | 'OC' | 'CL' | 'TC' | 'D' | 'IAN' | 'IA' | 'IC' | 'IT' | 'ID' | 'LP' | 'P' — **REQUIRED** when dispute is open to Visa Collaboration (Reason code 12 and 13 and Visa network brand). Collaboration is the new name for Visa's old chargeback process, where each party has several chances to investigate and submit evidence in order to determine whether a chargeback is legitimate.
`NR` = Merchandise/services not receive
`CR` = Cancelled recurring transaction
`ND` = Not as described
`DM` = Damaged or defective merchandise
`Q` = Quality
`CM` = Counterfeit merchandise
`M` = Misrepresentation
`CN` = Credit not processed
`CS` = Cancelled merchandise/services
`OC` = Original credit not accepted
`CL` = Non-receipt of cash
`TC` = Terms of contract (virtual account)
`D` = Duplicate
`IAN` = Incorrect account number
`IA` = Incorrect amount
`IC` = Incorrect currency
`IT` = Incorrect transaction code
`ID` = Invalid data
`LP` = Late presentment
`P` = Paid by other means
For VISA, you need to fill out the `collaborationQuestionnaire` form object in the [Create dispute form](https://developers.pismo.io/pismo-docs/reference/post-v1-disputes-disputeid-forms) endpoint. - `chargeback_ref_num` string, nullable — Chargeback reference number. - `network_response_amount` number, nullable — Last amount disputed in the claim registered when getting new information from network brand. - `network_response_currency` string, nullable — Last currency of amount disputed in the claim registered when getting new information from network brand. - `is_first_installment` boolean — Dispute installment references authorization's first installment. - `network_return_reject_reason_code` integer, nullable — Formatted network reject reason information. - `network_return_reject_reason_code` integer — Formatted network reject reason information. - `network_response_error` string — Network response error. ## Other responses - `201` — Created - `400` — Bad request - `401` — Access token is missing or invalid - `404` — Not Found - `500` — Internal server error --- [API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/versions/935b62e16de4/schema)