Cards

List card disputes

Retrieve a list of card disputes.

get/issuing/card-disputes

Request

  • Base URL: https://api.column.com
  • URL: https://api.column.com/issuing/card-disputes
  • Auth: HTTP basic

Query parameters

card_transaction_idstring

Filter card disputes by card transaction ID.

ending_beforestring

A cursor for use in pagination. ending_before is a card dispute ID that defines your place in the list.

limitinteger

A limit on the number of objects to be returned, between 1 and 100. The default is 10.

stage'initiated' | 'disputed' | 'merchant_responded' | 'merchant_response_recalled' | 'prearbitration' | 'prearbitration_responded' | 'arbitration' | 'dispute_won' | 'dispute_close'

Filter card disputes by dispute stage.

starting_afterstring

A cursor for use in pagination. starting_after is a card dispute ID that defines your place in the list.

submission_status'not_required' | 'draft' | 'pending_submission' | 'submitted' | 'requires_action' | 'failed'

Filter card disputes by network submission status.

Response

Successful response

has_moreboolean required

Whether more card disputes are available.

Example response

{
  "card_disputes": [
    {
      "events": [
        {
          "id": "cdse_2x8gszy5folpA9s0TOCseE9ABDM",
          "linked_transaction_event_id": "ctxe_2x8gszy5folpA9s0TOCseE9ABDM"
        }
      ],
      "evidence": [
        {
          "id": "cdev_2x8gszy5folpA9s0TOCseE9ABDM",
          "narrative": "The cardholder did not authorize this transaction and still has the card."
        }
      ],
      "id": "cdsp_2x8gszy5folpA9s0TOCseE9ABDM",
      "reason_details": {
        "canceled_merchandise_or_services": {
          "cancellation_method": "The cardholder canceled by email to the merchant's support address.",
          "merchandise_disposition": "The cardholder still has the merchandise and can return it on request.",
          "order_details": "A pair of running shoes ordered from the merchant's website.",
          "return_attempt_details": "The cardholder requested a return label, but the merchant did not respond.",
          "return_method_details": "The cardholder dropped the merchandise off at the merchant's retail store.",
          "return_tracking_number": "1Z999AA10123456784"
        },
        "canceled_recurring_transaction": {
          "cancellation_method": "The cardholder canceled by email to the merchant's support address.",
          "merchant_contact_application_name": "Acme Support Chat",
          "merchant_contact_email_address": "support@example.com",
          "merchant_contact_phone_number": "+14155550123"
        },
        "counterfeit_merchandise": {
          "counterfeit_details": "The brand's authentication service confirmed the item is not genuine.",
          "merchandise_disposition": "The cardholder still has the merchandise and can return it on request.",
          "order_details": "A pair of running shoes ordered from the merchant's website."
        },
        "credit_not_processed": {
          "late_credit_explanation": "The merchant delayed the credit while negotiating a partial refund with the cardholder."
        },
        "damaged_or_defective_merchandise": {
          "merchandise_disposition": "The cardholder still has the merchandise and can return it on request.",
          "negotiation_details": "The cardholder emailed the merchant twice asking for a refund and received no response.",
          "order_details": "A pair of running shoes ordered from the merchant's website.",
          "return_attempt_details": "The cardholder requested a return label, but the merchant did not respond.",
          "return_method_details": "The cardholder dropped the merchandise off at the merchant's retail store.",
          "return_tracking_number": "1Z999AA10123456784"
        },
        "duplicate_processing": {
          "other_card_transaction_id": "ctxn_3y9htaz6gomqB0t1UPDtfF0BCEN",
          "other_network_transaction_id": "305123456789012"
        },
        "fraud": {
          "card_mailed_postal_code": "94107"
        },
        "incorrect_currency": {
          "correct_currency": "USD"
        },
        "incorrect_transaction_code": {
          "credit_card_transaction_id": "ctxn_3y9htaz6gomqB0t1UPDtfF0BCEN",
          "credit_error_explanation": "The merchant processed a credit instead of reversing the original charge."
        },
        "invalid_data": {
          "authorization_decline_explanation": "The card had expired, so an authorization request with the correct expiration date would have been declined."
        },
        "merchandise_services_not_received": {
          "cancellation_method": "The cardholder canceled by email to the merchant's support address.",
          "dispute_before_expected_date_explanation": "The merchant confirmed the order was canceled and will not ship.",
          "late_delivery_details": "The merchandise was delivered three weeks after the agreed delivery date.",
          "order_details": "A pair of running shoes ordered from the merchant's website."
        },
        "misrepresentation": {
          "cancellation_method": "The cardholder canceled by email to the merchant's support address.",
          "misrepresentation_details": "The merchant advertised the jacket as waterproof, but it is not.",
          "negotiation_details": "The cardholder emailed the merchant twice asking for a refund and received no response.",
          "order_details": "A pair of running shoes ordered from the merchant's website.",
          "return_attempt_details": "The cardholder requested a return label, but the merchant did not respond.",
          "return_method_details": "The cardholder dropped the merchandise off at the merchant's retail store.",
          "return_tracking_number": "1Z999AA10123456784"
        },
        "not_as_described": {
          "cancellation_method": "The cardholder canceled by email to the merchant's support address.",
          "merchandise_disposition": "The cardholder still has the merchandise and can return it on request.",
          "negotiation_details": "The cardholder emailed the merchant twice asking for a refund and received no response.",
          "order_details": "A pair of running shoes ordered from the merchant's website.",
          "return_attempt_details": "The cardholder requested a return label, but the merchant did not respond.",
          "return_method_details": "The cardholder dropped the merchandise off at the merchant's retail store.",
          "return_tracking_number": "1Z999AA10123456784"
        },
        "original_credit_not_accepted": {
          "explanation": "The recipient's account was closed before the original credit arrived."
        },
        "paid_by_other_means": {
          "other_card_transaction_id": "ctxn_3y9htaz6gomqB0t1UPDtfF0BCEN",
          "other_network_transaction_id": "305123456789012"
        },
        "quality_of_merchandise_or_services": {
          "cancellation_method": "The cardholder canceled by email to the merchant's support address.",
          "merchandise_disposition": "The cardholder still has the merchandise and can return it on request.",
          "negotiation_details": "The cardholder emailed the merchant twice asking for a refund and received no response.",
          "order_details": "A pair of running shoes ordered from the merchant's website.",
          "return_attempt_details": "The cardholder requested a return label, but the merchant did not respond.",
          "return_method_details": "The cardholder dropped the merchandise off at the merchant's retail store.",
          "return_tracking_number": "1Z999AA10123456784"
        },
        "terms_of_contract": {
          "terms_not_honored_details": "The merchant did not deliver the services within the timeframe in the contract."
        }
      },
      "stage": "disputed",
      "submission_status": "submitted"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.