v1

latestOpenAPI 3.0.02026-07-26167441.9 MB

Dispute a chargeback

post/payments/{payment_id}/transactions/{transaction_id}/dispute

Path parameters

payment_idstring required

The unique identifier of the payment (UUID, 36 chars).

transaction_idstring required

The unique identifier of the transaction (UUID, 36 chars).

Request body

account_idstring required

The unique identifier of the account (UUID, 36 chars).

Response

200

idstring
account_idstring
descriptionstring
countrystring
statusstring
sub_statusstring
merchant_order_idstring
created_atstring
updated_atstring
{"stackTrail":"paths:/payments/{payment_id}/transactions/{transaction_id}/dispute:post:responses:200:content:application/json:schema:properties:checkout","oasType":"schema","type":"unknown"}
{"stackTrail":"paths:/payments/{payment_id}/transactions/{transaction_id}/dispute:post:responses:200:content:application/json:schema:properties:transactions_history","oasType":"schema","type":"unknown"}
split_marketplaceobject[]
callback_urlstring
workflowstring
{"stackTrail":"paths:/payments/{payment_id}/transactions/{transaction_id}/dispute:post:responses:200:content:application/json:schema:properties:fraud_screening","oasType":"schema","type":"unknown"}
payment_link_idstring
{"stackTrail":"paths:/payments/{payment_id}/transactions/{transaction_id}/dispute:post:responses:200:content:application/json:schema:properties:subscription_code","oasType":"schema","type":"unknown"}
simplified_modeboolean

Example response

{
  "id": "b001d824-3f3f-48fc-98ef-a3114b918c1e",
  "account_id": "210a524f-7ad3-437a-be7e-9e99bdf4d742",
  "description": "Test Purchase",
  "country": "AR",
  "status": "IN_DISPUTE",
  "sub_status": "PENDING_REVIEW",
  "merchant_order_id": "65742358",
  "created_at": "2025-11-26T20:34:08.330622Z",
  "updated_at": "2025-11-26T20:34:12.580560Z",
  "amount": {
    "currency": "ARS",
    "value": 2000
  },
  "payment_method": {
    "type": "CARD",
    "payment_method_detail": {
      "card": {
        "installments": 1,
        "authorization_code": "393119",
        "card_data": {
          "holder_name": "John Diaz",
          "iin": "45130761",
          "lfd": "5348",
          "number_length": 16,
          "security_code_length": 3,
          "brand": "VISA",
          "issuer_name": "BANCOLOMBIA",
          "country_code": "CO",
          "category": "CLASSIC",
          "type": "CREDIT",
          "fingerprint": "2213e58a-33d7-4bdc-8cbe-4785f683c410",
          "expiration_month": 6,
          "expiration_year": 26
        }
      }
    }
  },
  "customer_payer": {
    "id": "1b9ef2f7-b69e-4dd0-b0a1-3605dfc2ad2f",
    "merchant_customer_id": "6a1b6e7e0e104f28929015fd6182e9f9",
    "first_name": "Margarita",
    "last_name": "Parra",
    "gender": "NB",
    "date_of_birth": "1952-02-27",
    "email": "qpacheco@example.com",
    "nationality": "AR",
    "ip_address": "205.52.88.44",
    "device_fingerprint": "90ede54c-d2d4-4e2e-8189-6b81091231b0",
    "device_fingerprints": [
      {
        "provider_id": "DEFAULT",
        "id": "90ede54c-d2d4-4e2e-8189-6b81091231b0"
      }
    ],
    "browser_info": {
      "user_agent": "Chrome",
      "accept_header": "true",
      "accept_content": "true",
      "accept_browser": "true",
      "color_depth": "red",
      "screen_height": "500",
      "screen_width": "100",
      "javascript_enabled": true,
      "java_enabled": true,
      "browser_time_difference": "-3:00",
      "language": "es"
    },
    "document": {
      "document_type": "DNI",
      "document_number": "82183204"
    },
    "phone": {
      "number": "91112345678",
      "country_code": "54"
    },
    "billing_address": {
      "address_line_1": "Avenida Putumayo 1780",
      "address_line_2": "Diagonal 181G 6572",
      "country": "AR",
      "state": "Álava",
      "city": "Suárez",
      "zip_code": "25207",
      "neighborhood": "Barrio Núñez"
    },
    "shipping_address": {
      "address_line_1": "Diagonal 61 2487",
      "address_line_2": "Av. carrera 54 7627",
      "country": "AR",
      "state": "Guipúzcoa",
      "city": "San Benito",
      "zip_code": "31718",
      "neighborhood": "Villa La Esperanza"
    },
    "merchant_customer_created_at": "2025-11-26T20:34:06.941Z",
    "geolocation": {
      "latitude": "80.00",
      "longitude": "103.00"
    }
  },
  "additional_data": {
    "airline": {
      "pnr": "ABC123",
      "legs": [
        {
          "departure_airport": "JFK",
          "departure_datetime": "2024-07-03T05:00:00",
          "departure_airport_timezone": "GMT-05",
          "arrival_airport": "LAX",
          "arrival_airport_timezone": "+00:00",
          "arrival_datetime": "2030-07-03T22:59:00",
          "carrier_code": "AA",
          "flight_number": "123",
          "fare_basis_code": "Y",
          "fare_class_code": "S",
          "base_fare": 1800,
          "base_fare_currency": "USD",
          "stopover_code": "O",
          "departure_airport_country": "NL",
          "departure_airport_city": "Amsterdam",
          "arrival_airport_country": "AR",
          "arrival_airport_city": "Buenos aires"
        }
      ],
      "passengers": [
        {
          "first_name": "Antonio",
          "last_name": "Vargas",
          "middle_name": "Piedad",
          "type": "A",
          "date_of_birth": "1999-12-17",
          "nationality": "US",
          "document": {
            "document_type": "DNI",
            "document_number": "82183204"
          },
          "country": "CO",
          "loyalty_number": "79250001",
          "loyalty_tier": "DIAMOND",
          "email": "anaarias@example.com",
          "phone": {
            "number": "91112345678",
            "country_code": "54"
          }
        }
      ],
      "ticket": {
        "ticket_number": "BRB0001",
        "e_ticket": true,
        "total_fare_amount": 2000,
        "total_tax_amount": 180,
        "total_fee_amount": 20,
        "issue": {
          "carrier_prefix_code": "AA",
          "travel_agent_code": "A12345",
          "travel_agent_name": "TRAVEL AGENCY",
          "date": "2023-10-31",
          "address": "123 Main St",
          "city": "New York",
          "country": "US",
          "zip_code": "10001",
          "booking_system_code": "1G",
          "booking_system_name": "Galileo"
        }
      },
      "tickets": [
        {
          "ticket_number": "BRB0001",
          "e_ticket": true,
          "total_fare_amount": 2000,
          "total_tax_amount": 180,
          "total_fee_amount": 20,
          "issue": {
            "carrier_prefix_code": "AA",
            "travel_agent_code": "A12345",
            "travel_agent_name": "TRAVEL AGENCY",
            "date": "2023-10-31",
            "address": "123 Main St",
            "city": "New York",
            "country": "US",
            "zip_code": "10001",
            "booking_system_code": "1G",
            "booking_system_name": "Galileo"
          }
        }
      ]
    },
    "order": {
      "fee_amount": 1,
      "shipping_amount": 3,
      "tip_amount": 2,
      "items": [
        {
          "id": "97029",
          "name": "SKIRT",
          "quantity": 3,
          "unit_amount": 2000,
          "category": "OTHERS",
          "brand": "Barrera Group",
          "sku_code": "SC-01905",
          "manufacture_part_number": "MPN-70919"
        }
      ],
      "taxes": [
        {
          "type": "VAT",
          "tax_base": 100,
          "value": 10,
          "percentage": 10
        }
      ],
      "shipping": {
        "type": "ELECTRONIC",
        "description": "q4O6W8x8ONwpbgHjlxlz",
        "carrier": "AR_OCA",
        "deliver_at": "2025-11-26T20:34:07.500866Z"
      },
      "account_funding": {
        "sender": {
          "first_name": "Reinaldo",
          "last_name": "Rojas"
        },
        "beneficiary": {
          "first_name": "Leidy",
          "last_name": "González",
          "country": "AR",
          "date_of_birth": "1983-12-07",
          "phone": {
            "number": "91112345678",
            "country_code": "54"
          },
          "address": {
            "address_line_1": "Calle 4ª 3050",
            "address_line_2": "Carrera 98 6425",
            "country": "AR",
            "neighborhood": "Barrio Colegiales"
          }
        }
      },
      "tickets": [
        {
          "id": "57bfc6e7-c270-4fcc-a578-a76e6eaa4576",
          "name": "Ticket vitae",
          "description": "Description 4I%n",
          "type": "VIRTUAL",
          "amount": {
            "value": 2000,
            "currency": "ARS"
          },
          "event": {
            "id": "3e9d0621-e8ca-4415-9025-95d568cac569",
            "name": "Event doloremque",
            "description": "Description ipsam",
            "type": "CIRCUS",
            "date": "2025-11-26",
            "address": {
              "address_line_1": "Diagonal 33 2395",
              "address_line_2": "Cl. 112E 6497",
              "city": "Paz de Ariporo",
              "country": "AR",
              "state": "Lleida",
              "zip_code": "18124",
              "neighborhood": "Conjunto Los Laureles"
            }
          }
        }
      ],
      "discounts": [
        {
          "id": "10FF",
          "name": "10% Discount",
          "unit_amount": 10
        }
      ],
      "sales_channel": "marketplace"
    },
    "seller_details": {
      "name": "Mendoza-Cerón",
      "website": "http://navarro.info/category/postsregister.html",
      "email": "iospina@example.net",
      "address": {
        "address_line_1": "Av. calle 5ª 3906",
        "address_line_2": "Dg. 8ª 8965",
        "country": "AR",
        "state": "ARGENTINA",
        "city": "Curití",
        "zip_code": "15484"
      },
      "reference": "39245884",
      "country": "AR",
      "phone": {
        "number": "6844503463",
        "country_code": "23"
      },
      "document": {
        "document_type": "DNI",
        "document_number": "82183204"
      },
      "industry": "ELECTRONICS",
      "merchant_category_code": "6628"
    }
  },
  "transactions": {
    "id": "4a963490-70c2-4669-975a-a6901b4b5abf",
    "type": "CHARGEBACK",
    "status": "CREATED",
    "category": "CARD",
    "amount": 2000,
    "provider_id": "BAMBOO",
    "payment_method": {
      "type": "CARD",
      "detail": {
        "card": {
          "installments": 1,
          "authorization_code": "393119",
          "card_data": {
            "holder_name": "Pepito Perez",
            "iin": "45130761",
            "lfd": "5348",
            "number_length": 16,
            "security_code_length": 3,
            "brand": "VISA",
            "issuer_name": "BANCOLOMBIA",
            "country_code": "CO",
            "category": "CLASSIC",
            "type": "CREDIT",
            "fingerprint": "2213e58a-33d7-4bdc-8cbe-4785f683c410",
            "expiration_month": 6,
            "expiration_year": 26
          }
        }
      }
    },
    "response_code": "SUCCEEDED",
    "response_message": "CHARGEBACK_CREATED",
    "reason": "REQUESTED_BY_CUSTOMER",
    "description": "webhook transaction",
    "merchant_reference": "Reference-ac04c8a6-78c7-4588-b915-5498455369ef",
    "provider_data": {
      "id": "BAMBOO",
      "transaction_id": "121030201030210312",
      "status": "APPROVED"
    },
    "created_at": "2025-11-26T20:34:12.529203Z",
    "updated_at": "2025-11-26T20:34:12.559289Z"
  },
  "callback_url": "https://ibarra.info/tags/apphome.jsp",
  "workflow": "DIRECT",
  "metadata": [
    {
      "key": "explicabo",
      "value": "nihil"
    }
  ],
  "routing_rules": {
    "condition": {
      "id": 64972
    }
  }
}