Restofy Docs
Cierre del pedido POST

Consultar el estado del pago

POST /api/checkout/get-payment-status

Descripción

Dice si el cobro en línea del pedido sigue en proceso, quedó aprobado o fue rechazado.

Detalles

Revisa el último cobro del pedido y, si sigue en proceso, le pregunta a la pasarela en qué quedó. Cuando el banco lo aprueba, el pago se registra en el pedido. En los medios del banco también trae la dirección para terminar el pago cuando ya está lista.

Permisos requeridos

auth-order

Request

Este endpoint no recibe parámetros.

Respuesta

Campos que devuelve dentro de data. Nada fuera de esta lista sale en la respuesta.

Campo Tipo Descripción
transaction object Admite vacío Último cobro en línea del pedido; vacío si nunca se intentó pagar
transaction.paymentTransactionUuid string Identificador del cobro
transaction.methodType string Admite vacío Medio con que se envió el pago
transaction.status string Estado del cobro en la pasarela
transaction.isSent bool Si ya se envió a la pasarela
transaction.amountInCents int Monto del cobro, en centavos
transaction.asyncPaymentUrl string Admite vacío Dirección del banco para terminar el pago
transaction.reference string Referencia del cobro
transaction.statusMessage string Admite vacío Motivo que dio el banco
transaction.updatedAt datetime Último cambio del cobro

Ejemplo de request

curl -X POST https://restofy.pro/api/checkout/get-payment-status \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>"

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-10-09T02:12:12Z
HTTP 200

Request

[]

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "transaction": {
            "paymentTransactionUuid": "a98969d5-1939-4454-b93a-0dab55cc54b8",
            "methodType": "NEQUI",
            "status": "DECLINED",
            "isSent": true,
            "amountInCents": 2300000,
            "asyncPaymentUrl": null,
            "reference": "a98969d5-1939-4454-b93a-0dab55cc54b8",
            "statusMessage": null,
            "updatedAt": "2026-10-09T02:10:43.000Z"
        }
    }
}