Sign in

v1

latestOpenAPI 3.1.02026-07-245178279.0 KB
Pagos

Reembolsar Pago

Este request crea un reembolso de una orden identificada por el token de la orden, el reembolso puede ser:

  1. <b>Reembolso total</b>, en este caso no es necesario enviar el atributo amount.
  2. <b>Reembolso parcial</b>, debes enviar el atributo amount para especificar que es un reembolso parcial, indicando la cantidad a reembolsar. Dependiendo del PSP pueden ser asíncronos o no, para más información revisar la siguiente <a href="https://docs.deuna.com/docs/reembolsos-as%C3%ADncronos" target="_blank">guía</a>.
post/v2/merchants/orders/{order_token}/refund

Headers

X-API-KEYstring required

<a href="https://docs.deuna.com/reference/checkout-deuna#autenticaci%C3%B3n" target="_blank">Llave privada</a> 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

Deberá estar expresado en centavos; por ejemplo, si el monto es $10.00, estará representado como 1000, lo que significa 10 dólares y 0 centavos.

reasonstring required

Razón por la cual se efectua el reembolso de la orden.

Example request

{
  "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"
          }
        }
      ]
    }
  },
  "reason": "orden de prueba"
}

Response

Ejemplo de un Reembolso V2 exitoso