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"
}
}
}