Api de Consulta con Transferencia Bancaria

Usa esta consulta para verificar el estado actualizado de pagos con transferencia bancaria, especialmente cuando la confirmación no llega de inmediato y necesitas validar el resultado final desde backend.

GET /charges/{merchant_code}/{merchant_operation_number}/{transaction_id}

endpoint

Este flujo usa la misma estructura general documentada en el Overview de Consulta. Aquí se detalla específicamente el objeto operation.transactions[] para pagos con transferencia bancaria.

¿Cuándo usarla?

Estados pendientes

Cuando la autorización inicial deja la operación en seguimiento o PENDIENTE.

Segunda validación

Cuando necesitas confirmar desde backend si la transferencia terminó autorizada, denegada, expirada o cancelada.

Flujo con redirect

Cuando necesitas consultar continue_url, expiración o volver a dirigir al usuario para completar el pago.

Respaldo de S2S

Cuando no recibes confirmación inmediata vía notificaciones y necesitas validar el estado por consulta.

Consideraciones

Conserva merchant_code, merchant_operation_number y transaction_id desde la autorización para consultar sin ambigüedad.

En esta documentación se usa method_details para mantener consistencia con el resto de la referencia. Si en material previo encuentras method_detail, trátalo como el mismo objeto.

Los campos de processor_response para transferencia bancaria pueden variar según la procesadora o el banco. Tómalos como referenciales.

Response

Objeto operation.transactions[] para pagos con transferencia bancaria dentro de la trama de respuesta del API de Consulta.

Objeto `operation.transactions[]`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].transaction_id`	Identificador único de la transacción.	String	SI
`operation.transactions[].channel`	Canal por el cual se realizó la transacción. Valor esperado: `ecommerce`.	String	SI
`operation.transactions[].state`	Estado actual de la transacción. Valores frecuentes: `PENDIENTE`, `INVALIDO`, `AUTORIZADO`, `DENEGADO`, `CANCELADO`, `EXPIRADO`, `LIQUIDADO`.	String	SI
`operation.transactions[].state_reason`	Observación o detalle del estado.	String	SI
`operation.transactions[].amount`	Monto de la transacción.	String	SI
`operation.transactions[].currency`	Código de la moneda de la operación.	String	SI
`operation.transactions[].payment_method`	Objeto que contiene información sobre el método de pago usado en la transacción.	Object	SI
`operation.transactions[].payment_method.method_name`	Nombre del método de pago usado en la transacción. Valor esperado: `BANK_TRANSFER`.	String	SI
`operation.transactions[].payment_method.method_details`	Objeto que contiene información detallada relacionada al método.	Object	NO
`operation.transactions[].continue_url`	Visible en estado `PENDIENTE`. URL para continuar el proceso de pago.	String	NO
`operation.transactions[].expiration_date`	Visible en estado `PENDIENTE`. Objeto que contiene la fecha en la que expirará la transacción.	Object	NO
`operation.transactions[].processor_response`	Visible normalmente en estados `AUTORIZADO`, `DENEGADO` o `EXTORNADO`. Objeto que contiene el resultado de la autorización.	Object	NO
`operation.transactions[].additional_fields`	Objeto que contiene los datos adicionales de la transacción enviados en la autorización.	Object	NO
`operation.transactions[].lifecycle`	Array que contiene el listado de estados por los cuales pasó la transacción.	Array	SI

Objeto `operation.transactions[].payment_method.method_details`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].payment_method.method_details.redirect_url`	Visible en estado `PENDIENTE`. URL del redirect enviado en la autorización.	String	SI
`operation.transactions[].payment_method.method_details.callback_url`	URL del callback enviado en la autorización.	String	NO

Objeto `operation.transactions[].expiration_date`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].expiration_date.utc_time`	Fecha en UTC.	String	NO
`operation.transactions[].expiration_date.unix_time`	Fecha en Unix time.	Integer	NO

Objeto `operation.transactions[].processor_response`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].processor_response.origin_account`	Visible en estado `AUTORIZADO` o `DENEGADO`. Cuenta bancaria enmascarada desde donde se realizó la transferencia.	String	NO
`operation.transactions[].processor_response.request_id`	Visible en estado `AUTORIZADO` o `DENEGADO`. ID de la transacción generada por la procesadora.	String	NO
`operation.transactions[].processor_response.operation_id`	Visible en estado `AUTORIZADO` o `DENEGADO`. ID de la operación generada por el banco.	String	NO

Objeto `operation.transactions[].lifecycle`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].lifecycle[].state`	Estado de la transacción. Valores frecuentes: `REGISTRADO`, `PENDIENTE`, `INVALIDO`, `AUTORIZADO`, `DENEGADO`, `CANCELADO`, `EXPIRADO`, `LIQUIDADO`.	String	SI
`operation.transactions[].lifecycle[].date`	Objeto que contiene la fecha en la que se realizó el cambio de estado.	Object	SI

Objeto `operation.transactions[].lifecycle[].date`

Campo	Descripción	Tipo	Obligatorio
`operation.transactions[].lifecycle[].date.utc_time`	Fecha en UTC.	String	SI
`operation.transactions[].lifecycle[].date.unix_time`	Fecha en Unix time.	Integer	SI

Ejemplo: pendiente

Response de consulta de transferencia bancaria con estado PENDIENTE.

{
  "success": true,
  "merchant_code": "abc",
  "operation": {
    "merchant_operation_number": "2391645",
    "state": "PENDIENTE",
    "created_at": {
      "utc_time": "2024-03-12T22:49:36.018Z",
      "unix_time": 1710282940
    },
    "amount": "15000",
    "currency": "604",
    "transactions": [
      {
        "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
        "channel": "ecommerce",
        "state": "PENDIENTE",
        "state_reason": "Url generada para continuar con el pago",
        "amount": "15000",
        "currency": "604",
        "payment_method": {
          "method_name": "BANK_TRANSFER",
          "method_details": {
            "redirect_url": "https://pay-me.com",
            "callback_url": "https://pay-me.com/callback"
          }
        },
        "continue_url": "https://api.dev.alignet.io/payment/continue/bank_transfer/c7dagnrwgxgh1b6kzwirheezv",
        "expiration_date": {
          "utc_time": "2024-03-12T22:49:36.018Z",
          "unix_time": 1710282940
        },
        "processor_response": null,
        "additional_fields": null,
        "lifecycle": [
          {
            "state": "REGISTRADO",
            "date": {
              "utc_time": "2024-03-12T22:49:36.018Z",
              "unix_time": 1710282940
            }
          },
          {
            "state": "PENDIENTE",
            "date": {
              "utc_time": "2024-03-12T22:49:36.018Z",
              "unix_time": 1710282940
            }
          }
        ]
      }
    ]
  },
  "meta": {
    "status": {
      "code": "00",
      "message_ilgn": [
        {
          "locale": "es_PE",
          "value": "Se proceso correctamente"
        }
      ]
    }
  }
}

Ejemplo: autorizada

Response de consulta de transferencia bancaria con estado AUTORIZADO.

{
  "success": true,
  "merchant_code": "abc",
  "operation": {
    "merchant_operation_number": "2391645",
    "state": "AUTORIZADO",
    "amount": "15000",
    "currency": "604",
    "transactions": [
      {
        "transaction_id": "5hk8rwa3h3cq9oyfs3a28v1ms",
        "channel": "ecommerce",
        "state": "AUTORIZADO",
        "state_reason": "Pago exitoso",
        "amount": "15000",
        "currency": "604",
        "payment_method": {
          "method_name": "BANK_TRANSFER",
          "method_details": {
            "redirect_url": "https://pay-me.com",
            "callback_url": "https://pay-me.com/callback"
          }
        },
        "continue_url": null,
        "expiration_date": null,
        "processor_response": {
          "origin_account": "055552",
          "request_id": "055552",
          "operation_id": "055552"
        },
        "additional_fields": null,
        "lifecycle": [
          {
            "state": "REGISTRADO",
            "date": {
              "utc_time": "2024-03-12T22:49:36.018Z",
              "unix_time": 1710282940
            }
          },
          {
            "state": "PENDIENTE",
            "date": {
              "utc_time": "2024-03-12T22:49:36.018Z",
              "unix_time": 1710282940
            }
          },
          {
            "state": "AUTORIZADO",
            "date": {
              "utc_time": "2024-03-12T22:49:36.018Z",
              "unix_time": 1710282940
            }
          }
        ]
      }
    ]
  },
  "meta": {
    "status": {
      "code": "00",
      "message_ilgn": [
        {
          "locale": "es_PE",
          "value": "Se proceso correctamente"
        }
      ]
    }
  }
}

Siguiente paso

API de Cancelación

Revisa la cancelación si tu flujo de negocio necesita anular una operación autorizada.

​¿Cuándo usarla?

Estados pendientes

Segunda validación

Flujo con redirect

Respaldo de S2S

​Consideraciones

​Response

​Objeto operation.transactions[]

​Objeto operation.transactions[].payment_method.method_details

​Objeto operation.transactions[].expiration_date

​Objeto operation.transactions[].processor_response

​Objeto operation.transactions[].lifecycle

​Objeto operation.transactions[].lifecycle[].date

​Ejemplo: pendiente

​Ejemplo: autorizada

​Siguiente paso

API de Cancelación

¿Cuándo usarla?

Consideraciones

Response

Objeto `operation.transactions[]`

Objeto `operation.transactions[].payment_method.method_details`

Objeto `operation.transactions[].expiration_date`

Objeto `operation.transactions[].processor_response`

Objeto `operation.transactions[].lifecycle`

Objeto `operation.transactions[].lifecycle[].date`

Ejemplo: pendiente

Ejemplo: autorizada

Siguiente paso