--- title: "Add a dispute to an intake" method: POST path: "/disputes/intake/{disputeIntakeUUID}/new-dispute" tags: ["Dispute Intakes"] --- # Add a dispute to an intake `POST /disputes/intake/{disputeIntakeUUID}/new-dispute` ## Request - Base URL: `https://api.uat.paymentology.com/pty` - URL: `https://api.uat.paymentology.com/pty/disputes/intake/{disputeIntakeUUID}/new-dispute` - Auth: HTTP bearer Adds a dispute to an initialized disputes intake and returns document upload URLs if number of supporting documents is provided. ## Path parameters - `disputeIntakeUUID` string, uuid, required ## Request body - AddDisputeToDisputeIntakeRequest - `disputeUUID` string, uuid, required: Client-Provided Identifier of the dispute to add to the intake. - `numberOfSupportingDocuments` integer: Number of supporting documents that will be uploaded for a dispute. - `transaction` DisputeTransaction, required - `transactionId` string, required: Unique identifier of the transaction. - `arn` string, required: Acquirer Reference Number associated with the transaction. - `merchantName` string, required: Name of the merchant that processed the transaction. - `transactionAmount` number, double, required: Amount of the disputed transaction. - `transactionDate` string, date-time, required: Date and time the transaction occurred. - `cardIdentifier` string, required: Identifier of the card used for the transaction. - `maskedPan` string, required: Masked primary account number for the card. - `transactionSource` 'MASTERCARD' | 'VISA' | 'MEXICO_DOMESTIC', required: Card network for the disputed transaction. - `dispute` DisputeIntakeDisputeDetails, required - `disputeAmount` number, double, required: Disputed amount. - `isPartial` boolean, required: Indicates whether the dispute is partial. - `currency` string, required: Currency code in ISO 4217 alphabetic format (e.g. EUR, USD, MXN). - `cardholderAcknowledgement` 'DISPUTE' | 'AUTH' | 'FRAUD', required: Cardholder acknowledgement. - `formContent` union, required: Network-specific dispute form content. Exactly one supported network-specific object must be provided alongside `version`, and the populated object must match `transaction.transactionSource`. - object - `version` string, required: Version of the dispute form template. - `mastercard` MastercardFormContent, required: Mastercard-specific dispute form fields. Detailed required-field rules depend on the chosen reason path and are validated by the dispute service. - `recognizeTransaction` boolean: Whether the cardholder recognizes the transaction. - `reasonCode` '4841' | '4853' | '4855' | '4859' | '4860' | '4861' | '4862' | '4867' | '4864' | '4865' | '4866' | '4837' | '4831' | '4834' | '4842' | '4846' | '4840' | '4849' | '4863' | '4870' | '4871': Supported Mastercard dispute reason code. | Reason code | Description | Mapped reason code | Category | | --- | --- | --- | --- | | 4841 | Cancelled Recurring or Digital Goods Transactions | 4853 | Cardholder dispute | | 4853 | Cardholder Dispute - Defective/Not as described | 4853 | Cardholder dispute | | 4855 | Goods or Services Not Delivered | 4853 | Cardholder dispute | | 4859 | Addendum | 4853 | Cardholder dispute | | 4860 | Credit not processed | 4853 | Cardholder dispute | | 4861 | Digital goods were purchased totaling USD 25.00 or less and did not have adequate purchase controls | 4853 | Cardholder dispute | | 4862 | Counterfeit goods alleged to be authentic were purchased | 4853 | Cardholder dispute | | 4867 | Recurring agreement was not properly disclosed | 4853 | Cardholder dispute | | 4864 | "No-Show" hotel charge was billed | 4853 | Cardholder dispute | | 4865 | Purchase transaction did not complete | 4853 | Cardholder dispute | | 4866 | Timeshare agreement or similar service provision was cancelled within Mastercard time frame | 4853 | Cardholder dispute | | 4837 | No Cardholder Authorisation | 4837 | No Cardholder Authorisation | | 4831 | Disputed Amount | 4834 | Point-of-Interaction Error | | 4834 | Duplicate Processing of Transaction | 4834 | Point-of-Interaction Error | | 4842 | Late presentment | 4808 | Point-of-Interaction Error | | 4846 | Currency Error | 4834 | Point-of-Interaction Error | | 4859 | ATM Dispute, Loss, Theft, or Damages | 4834 | Point-of-Interaction Error | | 4840 | Fraudulent Processing of Transactions | 4840 | Fraud Dispute | | 4849 | Questionable Merchant Activity | 4849 | Fraud Dispute | | 4863 | Cardholder Does Not Recognise - Potential Fraud | 4863 | Fraud Dispute | | 4870 | Chip Liability Shift | 4870 | Fraud Dispute | | 4871 | Chip Liability Shift - Lost/Stolen/Never Received Issue (NRI) Fraud | 4871 | Fraud Dispute | - `cardholderParticipation` boolean: Whether the cardholder participated in the transaction or service interaction. - `goodsDescription` string: Description of goods or services involved in the dispute. - `disputeDescription` string: Free-text explanation of the dispute reason. - `additionalInformation` string: Additional network-specific context supplied by the cardholder. - `visa` VisaFormContent: Visa-specific dispute form fields. Detailed required-field rules depend on the selected dispute path and are validated by the dispute service. - `recognizeTransaction` boolean: Whether the cardholder recognizes the transaction. - `reasonCode` '10.1' | '10.2' | '10.3' | '10.4' | '10.5' | '12.2' | '12.5' | '12.6.1' | '12.6.2' | '13.1' | '13.2' | '13.3' | '13.4' | '13.5' | '13.6' | '13.7': Supported Visa dispute reason code. | Code | Description | Category | | --- | --- | --- | | 10.1 | EMV Liability Shift Counterfeit Fraud | Fraud | | 10.2 | EMV Liability Shift Non-Counterfeit Fraud | Fraud | | 10.3 | Other Fraud — Card-Present Environment | Fraud | | 10.4 | Other Fraud — Card-Absent Environment | Fraud | | 10.5 | Visa Fraud Monitoring Program | Fraud | | 12.2 | Incorrect Transaction Code | Processing Errors | | 12.5 | Incorrect Amount | Processing Errors | | 12.6.1 | Duplicate Processing | Processing Errors | | 12.6.2 | Paid by Other Means | Processing Errors | | 13.1 | Merchandise or Services Not Received | Consumer Disputes | | 13.2 | Canceled Recurring | Consumer Disputes | | 13.3 | Not as Described or Defective Merchandise or Services | Consumer Disputes | | 13.4 | Counterfeit Merchandise | Consumer Disputes | | 13.5 | Misrepresentation | Consumer Disputes | | 13.6 | Credit Not Processed | Consumer Disputes | | 13.7 | Canceled Merchandise or Services | Consumer Disputes | - `disputeReason` string: Human-readable selected dispute reason label. - `disputeReasonAnswer` string: Follow-up answer for the selected dispute reason when applicable. - `merchantResolutionAttempt` boolean: Whether the cardholder tried to resolve the dispute with the merchant. - `merchantResolutionExplanation` string: Explanation for the merchant-resolution attempt. - `disputeDescription` string: Human-readable description for the selected Visa reason code. - `additionalInformation` string: Additional network-specific context supplied by the cardholder. - `mexicoDomestic` MexicoDomesticFormContent: Mexico domestic dispute form fields. Detailed required-field rules depend on the chosen dispute path and are validated by the dispute service. - `recognizeTransaction` boolean: Whether the cardholder recognizes the transaction. - `reasonCode` '41' | '57' | '60' | '63' | '64' | '68' | '70' | '71' | '72' | '74' | '75' | '76' | '79' | '80' | '82' | '84' | '85' | '86' | '92' | '94': Supported Mexico domestic dispute reason codes. | Reason code | Description (Spanish) | Description (English) | | --- | --- | --- | | 41 | TRANSACCIÓN RECURRENTE CANCELADA O NO SOLICITADA | Recurring transaction cancelled or not requested | | 57 | TRANSACCIÓN MÚLTIPLE NO AUTORIZADA POR EL T.H. | Multiple transaction not authorised by cardholder | | 60 | ORIGINAL O COPIA RECIBIDA ILEGIBLE O CON DATOS INCOM. | Original or copy received illegible or with incomplete data | | 63 | CHIP (EMV) | Chip (EMV) | | 64 | TRANSACCIÓN MANUAL EN TERMINAL ELECTRÓNICA | Manual transaction on electronic terminal | | 68 | TRANS. DE ORDEN TELEF/CORREO/INTERNET FRAUDULENTA | Fraudulent phone/mail/internet order transaction | | 70 | TARJETA BOLETINADA | Card on bulletin | | 71 | AUTORIZACIÓN DECLINADA | Authorisation declined | | 72 | TRANS. EXCEDE EL IMPORTE AUTORIZADO O FALTA DE AUT. | Transaction exceeds authorised amount or lacks authorisation | | 74 | PRESENTACIÓN EXTEMPORÁNEA | Late presentment | | 75 | AUTORIZACIÓN FALSA | False authorisation | | 76 | PEAJE / TAG | Toll / TAG | | 79 | COPIA U ORIGINAL DE PAGARE SOLICITADO NO RECIBIDO | Requested original or copy of payment slip not received | | 80 | ERROR EN PROCESO | Processing error | | 82 | PROCESO DUPLICADO O MÚLTIPLE | Duplicate or multiple processing | | 84 | FALTA DE FIRMA Y/O FIRMA EN ARCHIVO | Missing signature and/or signature on file | | 85 | VENTA FRUSTRADA / DEVOLUCIÓN NO PROCESADA | Cancelled sale / Unprocessed refund | | 86 | ALTERACIÓN DEL IMPORTE | Amount alteration | | 92 | RECEPTOR DE PAGOS CON ACTIVIDAD IRREGULAR, CAN. DE RESERV. GARANTIZADA, CARGOS DEMORADOS Y/O | Payment receiver with irregular activity, guaranteed reservation cancellation, delayed charges | | 94 | PAGO POR OTROS MEDIOS | Payment by other means | - `cardholderParticipation` boolean: Whether the cardholder participated in the transaction or service interaction. - `goodsDescription` string: Description of goods or services involved in the dispute. - `disputeDescription` string: Human-readable description for the selected Mexico domestic reason code. - `additionalInformation` string: Additional network-specific context supplied by the cardholder. - object - `version` string, required: Version of the dispute form template. - `mastercard` MastercardFormContent: Mastercard-specific dispute form fields. Detailed required-field rules depend on the chosen reason path and are validated by the dispute service. - `recognizeTransaction` boolean: Whether the cardholder recognizes the transaction. - `reasonCode` '4841' | '4853' | '4855' | '4859' | '4860' | '4861' | '4862' | '4867' | '4864' | '4865' | '4866' | '4837' | '4831' | '4834' | '4842' | '4846' | '4840' | '4849' | '4863' | '4870' | '4871': Supported Mastercard dispute reason code. | Reason code | Description | Mapped reason code | Category | | --- | --- | --- | --- | | 4841 | Cancelled Recurring or Digital Goods Transactions | 4853 | Cardholder dispute | | 4853 | Cardholder Dispute - Defective/Not as described | 4853 | Cardholder dispute | | 4855 | Goods or Services Not Delivered | 4853 | Cardholder dispute | | 4859 | Addendum | 4853 | Cardholder dispute | | 4860 | Credit not processed | 4853 | Cardholder dispute | | 4861 | Digital goods were purchased totaling USD 25.00 or less and did not have adequate purchase controls | 4853 | Cardholder dispute | | 4862 | Counterfeit goods alleged to be authentic were purchased | 4853 | Cardholder dispute | | 4867 | Recurring agreement was not properly disclosed | 4853 | Cardholder dispute | | 4864 | "No-Show" hotel charge was billed | 4853 | Cardholder dispute | | 4865 | Purchase transaction did not complete | 4853 | Cardholder dispute | | 4866 | Timeshare agreement or similar service provision was cancelled within Mastercard time frame | 4853 | Cardholder dispute | | 4837 | No Cardholder Authorisation | 4837 | No Cardholder Authorisation | | 4831 | Disputed Amount | 4834 | Point-of-Interaction Error | | 4834 | Duplicate Processing of Transaction | 4834 | Point-of-Interaction Error | | 4842 | Late presentment | 4808 | Point-of-Interaction Error | | 4846 | Currency Error | 4834 | Point-of-Interaction Error | | 4859 | ATM Dispute, Loss, Theft, or Damages | 4834 | Point-of-Interaction Error | | 4840 | Fraudulent Processing of Transactions | 4840 | Fraud Dispute | | 4849 | Questionable Merchant Activity | 4849 | Fraud Dispute | | 4863 | Cardholder Does Not Recognise - Potential Fraud | 4863 | Fraud Dispute | | 4870 | Chip Liability Shift | 4870 | Fraud Dispute | | 4871 | Chip Liability Shift - Lost/Stolen/Never Received Issue (NRI) Fraud | 4871 | Fraud Dispute | - `cardholderParticipation` boolean: Whether the cardholder participated in the transaction or service interaction. - `goodsDescription` string: Description of goods or services involved in the dispute. - `disputeDescription` string: Free-text explanation of the dispute reason. - `additionalInformation` string: Additional network-specific context supplied by the cardholder. - `visa` VisaFormContent, required: Visa-specific dispute form fields. Detailed required-field rules depend on the selected dispute path and are validated by the dispute service. - `recognizeTransaction` boolean: Whether the cardholder recognizes the transaction. - `reasonCode` '10.1' | '10.2' | '10.3' | '10.4' | '10.5' | '12.2' | '12.5' | '12.6.1' | '12.6.2' | '13.1' | '13.2' | '13.3' | '13.4' | '13.5' | '13.6' | '13.7': Supported Visa dispute reason code. | Code | Description | Category | | --- | --- | --- | | 10.1 | EMV Liability Shift Counterfeit Fraud | Fraud | | 10.2 | EMV Liability Shift Non-Counterfeit Fraud | Fraud | | 10.3 | Other Fraud — Card-Present Environment | Fraud | | 10.4 | Other Fraud — Card-Absent Environment | Fraud | | 10.5 | Visa Fraud Monitoring Program | Fraud | | 12.2 | Incorrect Transaction Code | Processing Errors | | 12.5 | Incorrect Amount | Processing Errors | | 12.6.1 | Duplicate Processing | Processing Errors | | 12.6.2 | Paid by Other Means | Processing Errors | | 13.1 | Merchandise or Services Not Received | Consumer Disputes | | 13.2 | Canceled Recurring | Consumer Disputes | | 13.3 | Not as Described or Defective Merchandise or Services | Consumer Disputes | | 13.4 | Counterfeit Merchandise | Consumer Disputes | | 13.5 | Misrepresentation | Consumer Disputes | | 13.6 | Credit Not Processed | Consumer Disputes | | 13.7 | Canceled Merchandise or Services | Consumer Disputes | - `disputeReason` string: Human-readable selected dispute reason label. - `disputeReasonAnswer` string: Follow-up answer for the selected dispute reason when applicable. - `merchantResolutionAttempt` boolean: Whether the cardholder tried to resolve the dispute with the merchant. - `merchantResolutionExplanation` string: Explanation for the merchant-resolution attempt. - `disputeDescription` string: Human-readable description for the selected Visa reason code. - `additionalInformation` string: Additional network-specific context supplied by the cardholder. - `mexicoDomestic` MexicoDomesticFormContent: Mexico domestic dispute form fields. Detailed required-field rules depend on the chosen dispute path and are validated by the dispute service. - `recognizeTransaction` boolean: Whether the cardholder recognizes the transaction. - `reasonCode` '41' | '57' | '60' | '63' | '64' | '68' | '70' | '71' | '72' | '74' | '75' | '76' | '79' | '80' | '82' | '84' | '85' | '86' | '92' | '94': Supported Mexico domestic dispute reason codes. | Reason code | Description (Spanish) | Description (English) | | --- | --- | --- | | 41 | TRANSACCIÓN RECURRENTE CANCELADA O NO SOLICITADA | Recurring transaction cancelled or not requested | | 57 | TRANSACCIÓN MÚLTIPLE NO AUTORIZADA POR EL T.H. | Multiple transaction not authorised by cardholder | | 60 | ORIGINAL O COPIA RECIBIDA ILEGIBLE O CON DATOS INCOM. | Original or copy received illegible or with incomplete data | | 63 | CHIP (EMV) | Chip (EMV) | | 64 | TRANSACCIÓN MANUAL EN TERMINAL ELECTRÓNICA | Manual transaction on electronic terminal | | 68 | TRANS. DE ORDEN TELEF/CORREO/INTERNET FRAUDULENTA | Fraudulent phone/mail/internet order transaction | | 70 | TARJETA BOLETINADA | Card on bulletin | | 71 | AUTORIZACIÓN DECLINADA | Authorisation declined | | 72 | TRANS. EXCEDE EL IMPORTE AUTORIZADO O FALTA DE AUT. | Transaction exceeds authorised amount or lacks authorisation | | 74 | PRESENTACIÓN EXTEMPORÁNEA | Late presentment | | 75 | AUTORIZACIÓN FALSA | False authorisation | | 76 | PEAJE / TAG | Toll / TAG | | 79 | COPIA U ORIGINAL DE PAGARE SOLICITADO NO RECIBIDO | Requested original or copy of payment slip not received | | 80 | ERROR EN PROCESO | Processing error | | 82 | PROCESO DUPLICADO O MÚLTIPLE | Duplicate or multiple processing | | 84 | FALTA DE FIRMA Y/O FIRMA EN ARCHIVO | Missing signature and/or signature on file | | 85 | VENTA FRUSTRADA / DEVOLUCIÓN NO PROCESADA | Cancelled sale / Unprocessed refund | | 86 | ALTERACIÓN DEL IMPORTE | Amount alteration | | 92 | RECEPTOR DE PAGOS CON ACTIVIDAD IRREGULAR, CAN. DE RESERV. GARANTIZADA, CARGOS DEMORADOS Y/O | Payment receiver with irregular activity, guaranteed reservation cancellation, delayed charges | | 94 | PAGO POR OTROS MEDIOS | Payment by other means | - `cardholderParticipation` boolean: Whether the cardholder participated in the transaction or service interaction. - `goodsDescription` string: Description of goods or services involved in the dispute. - `disputeDescription` string: Human-readable description for the selected Mexico domestic reason code. - `additionalInformation` string: Additional network-specific context supplied by the cardholder. - object - `version` string, required: Version of the dispute form template. - `mastercard` MastercardFormContent: Mastercard-specific dispute form fields. Detailed required-field rules depend on the chosen reason path and are validated by the dispute service. - `recognizeTransaction` boolean: Whether the cardholder recognizes the transaction. - `reasonCode` '4841' | '4853' | '4855' | '4859' | '4860' | '4861' | '4862' | '4867' | '4864' | '4865' | '4866' | '4837' | '4831' | '4834' | '4842' | '4846' | '4840' | '4849' | '4863' | '4870' | '4871': Supported Mastercard dispute reason code. | Reason code | Description | Mapped reason code | Category | | --- | --- | --- | --- | | 4841 | Cancelled Recurring or Digital Goods Transactions | 4853 | Cardholder dispute | | 4853 | Cardholder Dispute - Defective/Not as described | 4853 | Cardholder dispute | | 4855 | Goods or Services Not Delivered | 4853 | Cardholder dispute | | 4859 | Addendum | 4853 | Cardholder dispute | | 4860 | Credit not processed | 4853 | Cardholder dispute | | 4861 | Digital goods were purchased totaling USD 25.00 or less and did not have adequate purchase controls | 4853 | Cardholder dispute | | 4862 | Counterfeit goods alleged to be authentic were purchased | 4853 | Cardholder dispute | | 4867 | Recurring agreement was not properly disclosed | 4853 | Cardholder dispute | | 4864 | "No-Show" hotel charge was billed | 4853 | Cardholder dispute | | 4865 | Purchase transaction did not complete | 4853 | Cardholder dispute | | 4866 | Timeshare agreement or similar service provision was cancelled within Mastercard time frame | 4853 | Cardholder dispute | | 4837 | No Cardholder Authorisation | 4837 | No Cardholder Authorisation | | 4831 | Disputed Amount | 4834 | Point-of-Interaction Error | | 4834 | Duplicate Processing of Transaction | 4834 | Point-of-Interaction Error | | 4842 | Late presentment | 4808 | Point-of-Interaction Error | | 4846 | Currency Error | 4834 | Point-of-Interaction Error | | 4859 | ATM Dispute, Loss, Theft, or Damages | 4834 | Point-of-Interaction Error | | 4840 | Fraudulent Processing of Transactions | 4840 | Fraud Dispute | | 4849 | Questionable Merchant Activity | 4849 | Fraud Dispute | | 4863 | Cardholder Does Not Recognise - Potential Fraud | 4863 | Fraud Dispute | | 4870 | Chip Liability Shift | 4870 | Fraud Dispute | | 4871 | Chip Liability Shift - Lost/Stolen/Never Received Issue (NRI) Fraud | 4871 | Fraud Dispute | - `cardholderParticipation` boolean: Whether the cardholder participated in the transaction or service interaction. - `goodsDescription` string: Description of goods or services involved in the dispute. - `disputeDescription` string: Free-text explanation of the dispute reason. - `additionalInformation` string: Additional network-specific context supplied by the cardholder. - `visa` VisaFormContent: Visa-specific dispute form fields. Detailed required-field rules depend on the selected dispute path and are validated by the dispute service. - `recognizeTransaction` boolean: Whether the cardholder recognizes the transaction. - `reasonCode` '10.1' | '10.2' | '10.3' | '10.4' | '10.5' | '12.2' | '12.5' | '12.6.1' | '12.6.2' | '13.1' | '13.2' | '13.3' | '13.4' | '13.5' | '13.6' | '13.7': Supported Visa dispute reason code. | Code | Description | Category | | --- | --- | --- | | 10.1 | EMV Liability Shift Counterfeit Fraud | Fraud | | 10.2 | EMV Liability Shift Non-Counterfeit Fraud | Fraud | | 10.3 | Other Fraud — Card-Present Environment | Fraud | | 10.4 | Other Fraud — Card-Absent Environment | Fraud | | 10.5 | Visa Fraud Monitoring Program | Fraud | | 12.2 | Incorrect Transaction Code | Processing Errors | | 12.5 | Incorrect Amount | Processing Errors | | 12.6.1 | Duplicate Processing | Processing Errors | | 12.6.2 | Paid by Other Means | Processing Errors | | 13.1 | Merchandise or Services Not Received | Consumer Disputes | | 13.2 | Canceled Recurring | Consumer Disputes | | 13.3 | Not as Described or Defective Merchandise or Services | Consumer Disputes | | 13.4 | Counterfeit Merchandise | Consumer Disputes | | 13.5 | Misrepresentation | Consumer Disputes | | 13.6 | Credit Not Processed | Consumer Disputes | | 13.7 | Canceled Merchandise or Services | Consumer Disputes | - `disputeReason` string: Human-readable selected dispute reason label. - `disputeReasonAnswer` string: Follow-up answer for the selected dispute reason when applicable. - `merchantResolutionAttempt` boolean: Whether the cardholder tried to resolve the dispute with the merchant. - `merchantResolutionExplanation` string: Explanation for the merchant-resolution attempt. - `disputeDescription` string: Human-readable description for the selected Visa reason code. - `additionalInformation` string: Additional network-specific context supplied by the cardholder. - `mexicoDomestic` MexicoDomesticFormContent, required: Mexico domestic dispute form fields. Detailed required-field rules depend on the chosen dispute path and are validated by the dispute service. - `recognizeTransaction` boolean: Whether the cardholder recognizes the transaction. - `reasonCode` '41' | '57' | '60' | '63' | '64' | '68' | '70' | '71' | '72' | '74' | '75' | '76' | '79' | '80' | '82' | '84' | '85' | '86' | '92' | '94': Supported Mexico domestic dispute reason codes. | Reason code | Description (Spanish) | Description (English) | | --- | --- | --- | | 41 | TRANSACCIÓN RECURRENTE CANCELADA O NO SOLICITADA | Recurring transaction cancelled or not requested | | 57 | TRANSACCIÓN MÚLTIPLE NO AUTORIZADA POR EL T.H. | Multiple transaction not authorised by cardholder | | 60 | ORIGINAL O COPIA RECIBIDA ILEGIBLE O CON DATOS INCOM. | Original or copy received illegible or with incomplete data | | 63 | CHIP (EMV) | Chip (EMV) | | 64 | TRANSACCIÓN MANUAL EN TERMINAL ELECTRÓNICA | Manual transaction on electronic terminal | | 68 | TRANS. DE ORDEN TELEF/CORREO/INTERNET FRAUDULENTA | Fraudulent phone/mail/internet order transaction | | 70 | TARJETA BOLETINADA | Card on bulletin | | 71 | AUTORIZACIÓN DECLINADA | Authorisation declined | | 72 | TRANS. EXCEDE EL IMPORTE AUTORIZADO O FALTA DE AUT. | Transaction exceeds authorised amount or lacks authorisation | | 74 | PRESENTACIÓN EXTEMPORÁNEA | Late presentment | | 75 | AUTORIZACIÓN FALSA | False authorisation | | 76 | PEAJE / TAG | Toll / TAG | | 79 | COPIA U ORIGINAL DE PAGARE SOLICITADO NO RECIBIDO | Requested original or copy of payment slip not received | | 80 | ERROR EN PROCESO | Processing error | | 82 | PROCESO DUPLICADO O MÚLTIPLE | Duplicate or multiple processing | | 84 | FALTA DE FIRMA Y/O FIRMA EN ARCHIVO | Missing signature and/or signature on file | | 85 | VENTA FRUSTRADA / DEVOLUCIÓN NO PROCESADA | Cancelled sale / Unprocessed refund | | 86 | ALTERACIÓN DEL IMPORTE | Amount alteration | | 92 | RECEPTOR DE PAGOS CON ACTIVIDAD IRREGULAR, CAN. DE RESERV. GARANTIZADA, CARGOS DEMORADOS Y/O | Payment receiver with irregular activity, guaranteed reservation cancellation, delayed charges | | 94 | PAGO POR OTROS MEDIOS | Payment by other means | - `cardholderParticipation` boolean: Whether the cardholder participated in the transaction or service interaction. - `goodsDescription` string: Description of goods or services involved in the dispute. - `disputeDescription` string: Human-readable description for the selected Mexico domestic reason code. - `additionalInformation` string: Additional network-specific context supplied by the cardholder. ## Response `201` Dispute accepted into the intake. - AddDisputeToDisputeIntakeResponse - `disputeIntakeUUID` string, uuid, required: Unique identifier of the dispute intake containing the accepted dispute. - `disputeIntakeItemUUID` string, uuid, required: Unique Identifier assigned to this dispute within the intake. - `disputeUUID` string, uuid, required: Client-Provided Identifier of the accepted dispute. - `documents` object[], required: Supporting documents and their presigned upload URLs. - `documentReference` string, uuid, required: Unique reference assigned to the supporting document. - `presignedUrl` string, uri, required: Presigned URL for uploading the supporting document. - `status` 'ACCEPTED', required: Acceptance state of the dispute in the intake. ## Other responses - `400`: Validation failure. The response body contains one of the following codes: - MALFORMED_REQUEST: The request body is not valid JSON or cannot be parsed. - MISSING_REQUIRED_FIELD: A required field is missing or empty, such as cardIdentifier, dateFrom, dateTo, disputeUUID, or a required dispute field. - INVALID_FIELD_TYPE: A field has the wrong type, such as a string where a number or boolean is required. - INVALID_UUID_FORMAT: disputeUUID, or disputeIntakeUUID is not a valid UUID. - INVALID_ENUM_VALUE: A field contains an unsupported value, such as transactionSource or cardholderAcknowledgement. - INVALID_DATE_FORMAT: A date or date-time does not use the documented format. - INVALID_AMOUNT: A dispute amount is not a valid decimal, or minAmount is greater than maxAmount. - INVALID_FORM_CONTENT: Form content is malformed, contains invalid fields, or does not match the transaction source. - `403`: Forbidden. The caller is authenticated but does not have permission to perform this operation. - `404`: Intake not found. - `500`: Unexpected server error. --- [API](https://skmtc.dev/paymentology/apis/disputes-intake-api.md) - [All operations](https://skmtc.dev/paymentology/apis/disputes-intake-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paymentology/apis/disputes-intake-api/revisions/54f60b71ea24?raw)