El modo automático es el modo predeterminado de la aplicación. A través suyo, la transacción se completa en una sola etapa y las modificaciones son limitadas. Está indicado para escenarios en los que toda la información necesaria para completar la transacción ya está disponible en el momento de crear la order, incluidos datos del comprador, ítems e información del medio de pago debidamente tokenizada.

En este flujo, toda la información se envía en una única solicitud y la API es responsable de orquestar la comunicación con las capas procesadoras. El estado devuelto en la respuesta de creación de la order dependerá de la configuración del parámetro capture_mode.

Para crear la order en modo automático, envía el campo processing_mode, responsable de definir el formato de creación y procesamiento de la transacción, como automatic. En el objeto transactions, el nodo payments debe contener el objeto payment_method completo, incluido el token de la tarjeta generado vía SDK o API, según el ejemplo a continuación:

La API devuelve el objeto de la order con el estado de la transacción ya actualizado (por ejemplo, processed o accredited):

json
Copiar
{
  "id": "01JC1KVZ0WJY8Y4WA7MZAD5S2T",
  "status": "processed",
  "status_detail": "accredited",
  "transactions": {
    "payments": [
      {
        "id": "pay_01JC1KVZ0WJY8Y4WA7MZG3A8F2",
        "status": "processed",
        "status_detail": "accredited",
        "payment_method": {
          "id": "master",
          "type": "credit_card",
          "installments": 12
        }
      }
    ]
  }
}

Las operaciones permitidas son:

• Crear order (con o sin transacciones)API: responsable por la creación y autorización de la order, pero sin procesamiento en simultáneo.
• Agregar transacciónAPI: esta operación de adición de transacciones solo puede realizarse en modo manual y es responsable de agregar más de una transacción en un mismo payload.
• Modificar transacciónAPI y/o eliminar transacciónAPI: la modificación y eliminación de transacciones solo pueden realizarse en modo manual, y permiten cambiar la información de pago que ya se había agregado anteriormente a una order. Es una operación que modifica un elemento dentro de cualquier campo del parámetro transactions.
• Capturar orderAPI: responsable por capturar el monto autorizado de una order. Esta opción solo es válida para tarjetas de crédito.
• Procesar transacciónAPI: permite ejecutar las transacciones creadas y/o modificadas en modo manual.
• Obtener orderAPI: permite obtener información sobre una order, incluido su status en tiempo real.
• Buscar orderAPI: permite buscar orders de forma masiva, utilizando diversos filtros e información de paginación.
• Cancelar orderAPI: responsable por la cancelación de una order ya existente, pero que aún no ha sido procesada/terminada.
• Reembolsar order o transacciónAPI: en modo manual se puede crear reembolsos totales o parciales de un pago. La order será reembolsada totalmente si todas las transacciones son reembolsadas por completo.
  • Reembolso total: no se debe indicar un monto a reembolsar en el body de la solicitud, que irá vacío.
  • Reembolso parcial: se debe especificar la cantidad a reembolsar en el body de la solicitud, junto con el ID de la transacción. Todas las otras transacciones permanecerán como están y solo la transacción modificada será reembolsada.