Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pay-me.com/llms.txt

Use this file to discover all available pages before exploring further.

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[]

CampoDescripciónTipoObligatorio
operation.transactions[].transaction_idIdentificador único de la transacción.StringSI
operation.transactions[].channelCanal por el cual se realizó la transacción. Valor esperado: ecommerce.StringSI
operation.transactions[].stateEstado actual de la transacción. Valores frecuentes: PENDIENTE, INVALIDO, AUTORIZADO, DENEGADO, CANCELADO, EXPIRADO, LIQUIDADO.StringSI
operation.transactions[].state_reasonObservación o detalle del estado.StringSI
operation.transactions[].amountMonto de la transacción.StringSI
operation.transactions[].currencyCódigo de la moneda de la operación.StringSI
operation.transactions[].payment_methodObjeto que contiene información sobre el método de pago usado en la transacción.ObjectSI
operation.transactions[].payment_method.method_nameNombre del método de pago usado en la transacción. Valor esperado: BANK_TRANSFER.StringSI
operation.transactions[].payment_method.method_detailsObjeto que contiene información detallada relacionada al método.ObjectNO
operation.transactions[].continue_urlVisible en estado PENDIENTE. URL para continuar el proceso de pago.StringNO
operation.transactions[].expiration_dateVisible en estado PENDIENTE. Objeto que contiene la fecha en la que expirará la transacción.ObjectNO
operation.transactions[].processor_responseVisible normalmente en estados AUTORIZADO, DENEGADO o EXTORNADO. Objeto que contiene el resultado de la autorización.ObjectNO
operation.transactions[].additional_fieldsObjeto que contiene los datos adicionales de la transacción enviados en la autorización.ObjectNO
operation.transactions[].lifecycleArray que contiene el listado de estados por los cuales pasó la transacción.ArraySI

​
Objeto operation.transactions[].payment_method.method_details

CampoDescripciónTipoObligatorio
operation.transactions[].payment_method.method_details.redirect_urlVisible en estado PENDIENTE. URL del redirect enviado en la autorización.StringSI
operation.transactions[].payment_method.method_details.callback_urlURL del callback enviado en la autorización.StringNO

​
Objeto operation.transactions[].expiration_date

CampoDescripciónTipoObligatorio
operation.transactions[].expiration_date.utc_timeFecha en UTC.StringNO
operation.transactions[].expiration_date.unix_timeFecha en Unix time.IntegerNO

​
Objeto operation.transactions[].processor_response

CampoDescripciónTipoObligatorio
operation.transactions[].processor_response.origin_accountVisible en estado AUTORIZADO o DENEGADO. Cuenta bancaria enmascarada desde donde se realizó la transferencia.StringNO
operation.transactions[].processor_response.request_idVisible en estado AUTORIZADO o DENEGADO. ID de la transacción generada por la procesadora.StringNO
operation.transactions[].processor_response.operation_idVisible en estado AUTORIZADO o DENEGADO. ID de la operación generada por el banco.StringNO

​
Objeto operation.transactions[].lifecycle

CampoDescripciónTipoObligatorio
operation.transactions[].lifecycle[].stateEstado de la transacción. Valores frecuentes: REGISTRADO, PENDIENTE, INVALIDO, AUTORIZADO, DENEGADO, CANCELADO, EXPIRADO, LIQUIDADO.StringSI
operation.transactions[].lifecycle[].dateObjeto que contiene la fecha en la que se realizó el cambio de estado.ObjectSI

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

CampoDescripciónTipoObligatorio
operation.transactions[].lifecycle[].date.utc_timeFecha en UTC.StringSI
operation.transactions[].lifecycle[].date.unix_timeFecha en Unix time.IntegerSI

​
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.