---
title: "POST /api/v4/integration/cash-in/register-payment"
method: POST
path: "/api/v4/integration/cash-in/register-payment"
---

# POST /api/v4/integration/cash-in/register-payment

`POST /api/v4/integration/cash-in/register-payment`

## Request body

- object
  - `userId` number, required — ID del usuario obtenido de /api/v4/integration/cash-in/search.
  - `storeId` number, required — ID de la sucursal en la que se recibe el pago.
  - `payments` object[], required — Lista de créditos y montos a pagar en la sucursal. Debe incluir al menos un pago.
    - `creditId` number, required — ID del crédito.
    - `amount` number, required — Monto a pagar.

## Response `201`

Pago registrado correctamente. Devuelve los datos del pago registrado.

- object
  - `globalPaymentId` number, required — ID del pago registrado.
  - `status` 'success' | 'pending_conciliation' | 'cancelled', required — success: conciliado; pending_conciliation: pendiente de conciliación; cancelled: cancelado.
  - `totalAmount` number, required — Monto total del pago registrado.
  - `appliedPayments` object[], required — Lista de créditos y montos aplicados en el pago registrado.
    - `creditId` string — ID del crédito.
    - `amount` string — Monto aplicado.
  - `message` string — Mensaje de confirmación.

## Other responses

- `400` — Datos incorrectos o validación fallida. Posibles causas: validación de schema (userId, payments, montos), sucursal no autorizada, monto mayor al permitido, créditos no válidos o no pertenecen al usuario.
- `401` — No autorizado.
- `404` — Recurso no encontrado.
- `500` — Error al registrar el pago o operación no permitida (ej. fuera de horario de sucursal).

---

[API](https://skmtc.dev/atratopago/apis/api-partners.md) · [All operations](https://skmtc.dev/atratopago/apis/api-partners/llms.txt) · [OpenAPI document](https://skmtc.dev/atratopago/apis/api-partners/revisions/67ec4734ac49?raw)