> ## Documentation Index > Fetch the complete documentation index at: https://docs.pagos.ai/llms.txt > Use this file to discover all available pages before exploring further. # Disputes ## OpenAPI ````yaml POST /v1/{account_id}/disputes openapi: 3.0.0 info: title: Pagos Ingestion API description: The Pagos Ingestion API Spec version: 1.1.1 contact: {} servers: - description: sandbox url: https://api.sandbox.nest.pagosapi.com - description: production url: https://api.nest.pagosapi.com security: [] tags: - name: ingestion description: Pagos Ingestion API paths: /v1/{account_id}/disputes: post: operationId: DisputesController_create parameters: - name: account_id required: true in: path schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/DisputeUploadRequest' responses: '201': description: '' components: schemas: DisputeUploadRequest: type: object properties: dispute_id: type: string minLength: 1 maxLength: 255 description: >- A unique value that identifies the dispute and will be used as the key when making updates to disputes. Maximum 255 characters. amount: type: integer minimum: 0 description: >- 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. amount_refunded: type: integer minimum: 0 nullable: true description: >- 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. currency: type: string minLength: 3 maxLength: 3 description: >- The currency of the dispute, represented by the 3-letter ISO-4217 currency code. Must be three characters. created: type: string description: >- The date when the dispute was created, represented in ISO 8601 format (e.g. 2023-09-04T16:13:05Z). transaction_id: type: string maxLength: 255 description: >- The transaction ID of the original transaction associated with the dispute. Maximum 255 characters. transaction_order_id: type: string maxLength: 255 nullable: true description: >- The merchant order reference of the original transaction associated with the dispute. Maximum 255 characters. payment_method_details: type: object properties: payment_method_type: type: string maxLength: 255 description: >- The payment method used for the disputed transaction (e.g. card, apple pay, paywithgoogle). Maximum 255 characters. card: type: object properties: attributes: type: object properties: network: type: string maxLength: 50 nullable: true description: >- The card brand used in the dispute (e.g. visa, mastercard, discover). Maximum 50 characters. type: type: string maxLength: 150 nullable: true description: >- The type of payment card used in the dispute (e.g. debit or credit). bin: type: string minLength: 5 maxLength: 8 nullable: true description: >- The first 4-9 digits of the payment card used in the dispute. issuer_bank: type: string maxLength: 128 nullable: true description: >- The issuing bank for the payment card used in the dispute. Maximum 128 characters. issuer_country: type: string minLength: 2 maxLength: 2 nullable: true description: >- The country where the card used in the dispute was issued, represented by a two-letter country code (ISO 3166 alpha-2). additionalProperties: false nullable: true additionalProperties: false nullable: true required: - payment_method_type additionalProperties: false dispute_response: type: object properties: status: type: string maxLength: 50 nullable: true description: >- The status of the dispute (e.g. won, lost, pending). Maximum 50 characters. reason_code: type: string maxLength: 50 nullable: true description: >- The reason code for the dispute, which maps to a dispute reason (e.g. duplicate processing, fraud, stolen card). Maximum 50 characters. reason: type: string maxLength: 255 nullable: true description: >- The reason for the dispute (e.g. duplicate processing, fraud, stolen card). Maximum 255 characters. additionalProperties: false nullable: true additional_data: type: object properties: merchant_account_id: type: string maxLength: 100 nullable: true description: >- A unique value assigned by the acquirer or processor to identify the merchant account. This value could match the merchant account ID associated with a region or country. Maximum 100 characters. order_id: type: string maxLength: 255 nullable: true description: The merchant order reference. Maximum 255 characters. acquirer_reference_number: type: string maxLength: 255 nullable: true description: >- The unique value assigned by the acquiring bank and passed through to the card brand and issuer. It's often used to track the transaction or link it to chargebacks, should they occur. Maximum 255 characters. metadata: type: object additionalProperties: nullable: true nullable: true description: >- A transaction-level label, represented as a JSON string and used to segment transactions into meaningful groups. Metadata is typically used for segmentation by customer behavior (e.g. purchases from a particular seller) or merchant behavior (e.g. transaction routing or retries). additionalProperties: false nullable: true pagos_codes: type: object properties: pagos_dispute_status: type: string enum: - 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 description: >- Assign a Pagos chargeback status code that corresponds to dispute_response.status. pagos_dispute_reason: type: string enum: - 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 nullable: true description: >- Assign a Pagos chargeback reason code that corresponds to reason or reason_code. Required when reason or reason_code contains a value. required: - pagos_dispute_status additionalProperties: false required: - dispute_id - amount - currency - created - transaction_id - payment_method_details - pagos_codes additionalProperties: false ````