v1

latestOpenAPI 3.1.02026-07-245178279.0 KB

Pagos

Capturar Autorización

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.

post/v2/merchants/orders/{order_token}/capture

Headers

X-API-KEYstring required

Llave privada del comercio

X-Idempotency-Keystring uuid

Example:550e8400-e29b-41d4-a716-446655440000

Opcional. UUID v4 que permite reintentar la misma solicitud de forma segura sin duplicar la operación: si se reenvía con la misma clave, se devuelve la respuesta original junto con el header de respuesta X-Idempotency-Replay: true. Si no se envía el header, el endpoint funciona con el comportamiento por defecto (sin idempotencia). Más detalles en <a href="https://docs.deuna.com/reference/idempotent-requests" target="_blank">Idempotent Requests</a>.

Request body

amountnumber 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_captureboolean

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.

Example request

{
  "amount": 1000,
  "final_capture": true,
  "order": {
    "airline_information": {
      "booking_items": [
        {
          "airline_3_digit_code": "012",
          "airline_iata_designator": "AB",
          "ancillaries": [
            {
              "description": "Premium meal",
              "service_category": "C",
              "ticket_number": "0011234567891",
              "total_amount": 1000,
              "type": "Meal"
            }
          ],
          "legs": [
            {
              "airport_tax_amount": 530,
              "carrier_code": "AA",
              "carrier_name": "American Airlines",
              "destination": {
                "date": "2022-03-14",
                "iata_code": "JFK",
                "time": "09:00"
              },
              "fare_basis_code": "Y",
              "flight_number": "123",
              "origin": {
                "date": "2022-03-14",
                "iata_code": "JFK",
                "time": "09:00"
              },
              "seat_location": "12A",
              "service_class": "J",
              "stopover_code": "X",
              "sub_total_amount": 4470,
              "tax_amount": 530,
              "total_amount": 5000
            }
          ],
          "passenger": {
            "country_code": "MX",
            "date_of_birth": "1990-01-01",
            "document_number": "1234567890",
            "document_type": "ID",
            "email": "john.d@email.com",
            "first_name": "John",
            "frequent_flyer_code": "1234567890",
            "last_name": "Smith",
            "middle_name": "Doe",
            "phone": "+1234567890",
            "title": "Mr.",
            "user_id": "123456"
          },
          "pnr": "ABC123",
          "reservation_system_code": "1S",
          "ticket_number": "012345678912345",
          "ticketing_travel_agency": {
            "agency_invoice_number": "123456",
            "iata_code": "12345678",
            "name": "Agencia de Viajes"
          }
        }
      ]
    }
  }
}

Response

Ok Respuesta de una captura exitosa