---
title: "Capturar Autorización"
method: POST
path: "/v2/merchants/orders/{order_token}/capture"
tags: ["Pagos"]
---

# Capturar Autorización

`POST /v2/merchants/orders/{order_token}/capture`

La opción de **capturar un pago autorizado** te permite completar una transacción con estado **authorized**.
Una transacción está en estado **authorized** cuando se reservaron los fondos necesarios para dicha transacción. Este servicio también permite hacer múltiples capturas parciales en caso de que se habilite la opción de captura parcial en el comercio.

## Headers

- `X-API-KEY` string, required
- `X-Idempotency-Key` string, uuid

## Request body

- object
  - `amount` number, required — Deberá estar expresado en centavos, por ejemplo si el monto es $10.00 estará representado como 1000 lo que significa 10 dólares 0 centavos.
  - `final_capture` boolean — Indica si la captura es final en una serie de capturas parciales. Si es `true`, no se podrán realizar más capturas sobre esta transacción.
  - `order` object
    - `airline_information` AirlineInformation — Objeto para la información de vuelos. Es Requerido solamente cuando **order_type** sea AIRLINE_ORDER.
      - `booking_items` BookingItem[] — Lista de items de la reserva, incluyendo tickets e información de la agencia de viajes.
        - `airline_3_digit_code` string — Código de 3 dígitos de la aerolínea.
        - `airline_iata_designator` string — Código de 2 dígitos para la aerolínea según el estándar IATA.
        - `ancillaries` Ancillary[] — Lista de servicios adicionales de la reserva.
          - `category_code` string — Código de categoría del servicio adicional, según los estándares de IATA (International Air Transport Association).
          - `description` string — Descripción del servicio adicional.
          - `fee_code` string — Código específico asignado al cargo o tasa del servicio adicional.
          - `service_category` string — Categoría del servicio adicional.
          - `sub_category_code` string — Código de subcategoría del servicio adicional, según los estándares de IATA (International Air Transport Association).
          - `ticket_number` string — Es el número identificador del servicio adicional.
          - `total_amount` integer — Monto del servicio adicional. Deberá estar expresado en centavos, por ejemplo si el monto es $10.00 estará representado como 1000 lo que significa 10 dólares 0 centavos.
          - `type` string — Es el tipo de servicio adicional.
          - `unit_price` integer — Precio unitario del servicio adicional. Deberá estar expresado en centavos, por ejemplo si el monto es $10.00 estará representado como 1000.
        - `e_ticket` boolean — Indica si el ticket es electrónico.
        - `legs` FlightLeg[] — Lista de vuelos de la reserva.
          - `airport_tax_amount` number — Es el monto de la tasa aeroportuaria incluida en el valor del tiquete. Debe estar expresado en centavos. Por ejemplo, si el monto es $10.00 debe representarse como 1000, lo que significa 10 dólares y 0 centavos.
          - `carrier_code` string — Código de la aerolínea que opera el vuelo. Este código debe tener una longitud de 2 caracteres.
          - `carrier_name` string — Nombre de la aerolínea que opera el vuelo.
          - `destination` FlightSegment — Objeto para la información de los segmentos de vuelo.
            - `city` string — Ciudad de origen o destino del vuelo.
            - `date` string — Fecha del vuelo en formato YYYY-MM-DD. Este campo es esencial para verificar la disponibilidad de vuelos y horarios.
            - `iata_code` string — Código IATA del aeropuerto. Este código debe tener siempre una longitud de 3 caracteres alfanuméricos.
            - `time` string — Hora del vuelo en formato HH:MM. Este campo es esencial para verificar la disponibilidad de vuelos y horarios.
          - `fare_basis_code` string — Código de base de tarifa del vuelo. Este campo es alfanumérico y puede tener una longitud máxima de 6 caracteres.
          - `flight_number` string — Número de vuelo. Este campo es alfanumérico y puede tener una longitud máxima de 6 caracteres.
          - `origin` FlightSegment — Objeto para la información de los segmentos de vuelo.
            - `city` string — Ciudad de origen o destino del vuelo.
            - `date` string — Fecha del vuelo en formato YYYY-MM-DD. Este campo es esencial para verificar la disponibilidad de vuelos y horarios.
            - `iata_code` string — Código IATA del aeropuerto. Este código debe tener siempre una longitud de 3 caracteres alfanuméricos.
            - `time` string — Hora del vuelo en formato HH:MM. Este campo es esencial para verificar la disponibilidad de vuelos y horarios.
          - `seat_location` string — Ubicación del asiento del pasajero en el vuelo.
          - `service_class` string — Código que indica el tipo de clase del vuelo. Puede ir de la A a la Z. Por ejemplo, dependiendo de la aerolínea, la letra "J" representa un vuelo de clase ejecutiva, "I" business, etc.
          - `stopover_code` 'X' | 'O' — Código que indica si el vuelo tiene una escala. "X" será para vuelos directos (array de legs con 1 elemento) y "O" para vuelos con escala (array de legs con 2 o más elementos).
          - `sub_total_amount` number — Es el monto del subtotal del vuelo. Este monto es sin impuestos. Deberá estar expresado en centavos, por ejemplo si el monto es $10.00 estará representado como 1000 lo que significa 10 dólares 0 centavos.
          - `tax_amount` number — Es el total de los impuestos del vuelo. Deberá estar expresado en centavos, por ejemplo si el monto es $10.00 estará representado como 1000 lo que significa 10 dólares 0 centavos.
          - `total_amount` number — Es el total del vuelvo esto comprende la suma del total de sub_total y total_tax_amount. Deberá estar expresado en centavos, por ejemplo si el monto es $10.00 estará representado como 1000 lo que significa 10 dólares 0 centavos.
        - `passenger` Passenger — Objeto para la información del pasajero.
          - `country_code` string — Código de país del pasajero, de acuerdo con el estándar ISO 3166-1 alpha-2.
          - `date_of_birth` string — Fecha de nacimiento del pasajero en formato YYYY-MM-DD. Este campo es esencial para verificar la elegibilidad de los pasajeros basados en la edad se debe seguir estrictamente el formato de fecha para asegurar la correcta validación.
          - `document_number` string — Número de documento de identificación del pasajero.
          - `document_type` string — Tipo de documento de identificación del pasajero. Para viajes domésticos el valor puede ser DNI o ID, para viajes internacionales se requiere el valor de Passport.
          - `email` string, email — Correo electrónico del pasajero.
          - `first_name` string — Nombre del pasajero.
          - `frequent_flyer_code` string — Número de tarjeta de viajero frecuente del pasajero. Este campo es alfanumérico.
          - `last_name` string — Apellido del pasajero.
          - `middle_name` string — Segundo nombre del pasajero.
          - `phone` string — Número de teléfono del pasajero, incluyendo el código de país en caso de ser necesario.
          - `title` string — Título de cortesía del pasajero.
          - `type` 'ADT' | 'CNN' | 'INF' | 'INS' | 'CHD' | 'SRC' | 'YTH' | 'MIL' | 'SEA' | 'STU' | 'JCB' | 'LAB' | 'ZZZ' — Type of the passenger according to IATA standard passenger type codes (PTC). Should be 3 characters long. These codes identify the category of the passenger (e.g., adult, child, infant, senior, etc.) for pricing, taxation, and fare qualification. ZZZ is the default value.
          - `user_id` string — Identificador de usuario del pasajero, proporcionado por la aplicación que realiza la integración. Este campo es almacenado como un string, su formato puede ser un UUID o cualquier otro identificador único.
        - `pnr` string — Número de reserva de la aerolínea.
        - `reservation_system_code` string — Código que identifica al sistema de reserva (GDS) utilizado para realizar la reserva y emitir el boleto.
        - `ticket_number` string — Número de ticket para la reserva. El número de ticket generalmente debe tener una longitud de 13 dígitos numéricos (por el estándar IATA). Pero puede tener una longitud maxima de 15 dígitos para algunos casos especiales.
        - `ticketing_travel_agency` TicketingTravelAgency — Objeto para la información de la agencia de viajes. Es Requerido solamente cuando el OrderType sea AIRLINE_ORDER.
          - `agency_invoice_number` string — Número de factura emitido por la agencia de viajes IATA o la aerolínea.
          - `iata_code` string — Código IATA de la agencia de viajes que emitió el ticket. Este código debe tener una longitud de 8 caracteres pero puede tener una longitud máxima de 12 caracteres para algunos casos especiales.
          - `name` string — Nombre de la agencia de viajes.

## Response `200`

Ok Respuesta de una captura exitosa

- object
  - `data` object
    - `capture_amount` object
      - `amount` string
      - `currency` string
    - `capture_id` string
    - `captures` object[] — Lista de las capturas realizadas en la orden autorizada
      - `capture_amount` object
        - `amount` string — Monto de la captura
        - `currency` string — Moneda de la captura
      - `capture_id` string — Identificador de la captura
      - `captured_on` string — Fecha y hora de la captura
      - `external_transaction_id` string — Identificador de la transacción externa asociada a la captura
      - `status` string — Estado de la captura
    - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `409` — Conflict
- `422` — Unprocessable Entity

---

[API](https://skmtc.dev/deuna/apis/user-network-api.md) · [All operations](https://skmtc.dev/deuna/apis/user-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deuna/user-network-api/revisions/df73fa00ed05/schema)