Cierre del pedido
POST
Enviar el pago a la pasarela
POST /api/checkout/process-payment
Descripción
Manda a la pasarela el cobro abierto del pedido con el medio que eligió el cliente.
Detalles
Envía el cobro del pedido con Nequi, PSE, Bancolombia o Daviplata y devuelve en qué quedó. Los medios que terminan en el banco entregan unos segundos después la dirección a la que va el cliente. Nunca cobra dos veces: exige un cobro abierto sin enviar. Al terminar en el banco, el cliente vuelve al chat desde el que pagó.
Permisos requeridos
auth-order
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| chatUuid | string | No |
min:36
max:36
|
| deviceUuid | string | No |
min:36
max:36
|
| paymentMethod | object | Sí | — |
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/process-payment \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"paymentMethod": []
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-10-09T02:12:12Z
HTTP 200
Request
{
"paymentMethod": {
"methodType": "NEQUI",
"phoneNumber": "3001234567",
"sandboxStatus": "PENDING"
}
}Response
{
"success": true,
"message": "Operación realizada correctamente",
"data": {
"transaction": {
"paymentTransactionUuid": "a8c04b41-7275-40c7-b175-60d669647259",
"methodType": "NEQUI",
"status": "PENDING",
"isSent": true,
"amountInCents": 2300000,
"asyncPaymentUrl": null,
"reference": "a8c04b41-7275-40c7-b175-60d669647259",
"statusMessage": null,
"updatedAt": "2026-10-09T01:58:59.000Z"
}
}
}