Actualizar pago recibido ya reclamado
PUT /api/received-payments/{received_payment_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Corrige la asignación de un pago ya reclamado (otro comprobante, método o destino). Elimina el pago del comprobante generado antes y registra uno nuevo con los datos enviados.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.
Parámetros de la URL:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
id |
integer | Sí | Id del pago recibido. |
Cuerpo (JSON):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
document_id |
integer | Sí | Id del comprobante a pagar (debe existir). |
payment_method_type_id |
string | Sí | Método de pago existente (p. ej. el de Yape o Plin de la empresa). |
payment_destination_id |
string/integer | Sí | cash o id de cuenta bancaria / billetera. |
Reglas de caja: cuando una regla de caja impide la operación responde 422 con {success: false, message, cash_rule: true}; el message explica la causa y puede mostrarse al usuario tal cual (caja cerrada, sin caja abierta para un pago en efectivo, pago duplicado en menos de 20 segundos, etc.).
Errores:
422si el pago no está en estadomatched.422{success: false, message: {campo: [errores]}}si falla la validación de campos.500si el id no existe (el mensaje técnico no es apto para mostrar al usuario: valida el id antes).
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
received_payment_id |
ruta | sí | 1 |
Cuerpo
Content-Type: application/json
{
"document_id": "1",
"payment_method_type_id": "12",
"payment_destination_id": "cash"
}
Respuestas
200 — Actualizado
{
"success": true,
"message": "Pago actualizado con exito",
"data": {
"id": 12,
"provider": "YAPE",
"amount": 25.5,
"sender_name": "MARIA LOPEZ",
"raw_text": "Yape! MARIA LOPEZ te envió un pago por S/ 25.50",
"package_name": "com.bcp.innovacxion.yapeapp",
"posted_at": "2026-11-07 13:42:05",
"device_id": "caja-1-android",
"dedup_hash": "a3f1c9e2b7d4...",
"status": "matched",
"matched_document_id": 1520,
"matched_document_payment_id": 58,
"claimed_by_user_id": 5,
"created_at": "2026-11-07 13:42:06"
}
}
422 — No reclamado
{
"success": false,
"message": "Solo se puede actualizar un pago que ya fue reclamado."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.