# API de LatinPay para comercios

> Versión 1.0.0. Referencia de la API de comercios de LatinPay: deudas, códigos de pago, carga masiva y webhooks.

## Documentación

- [Contrato (JSON)](https://doc.latinpay.pe/contract/latinpay.json): referencia completa y legible por máquinas (firma Ed25519 en `latinpay.json.sig`)
- [Documentación completa en un archivo](https://doc.latinpay.pe/llms-full.txt): introducción, endpoints y eventos de webhook
- [Referencia interactiva](https://doc.latinpay.pe/referencia)

## Guías

- [Introducción](https://doc.latinpay.pe/guias/introduccion)
- [Cobrar en tres pasos](https://doc.latinpay.pe/guias/cobrar-en-tres-pasos)
- [El código de búsqueda](https://doc.latinpay.pe/guias/el-codigo-de-busqueda)
- [URL base](https://doc.latinpay.pe/guias/url-base)
- [Cómo responde la API](https://doc.latinpay.pe/guias/como-responde-la-api)
- [Autenticación](https://doc.latinpay.pe/guias/autenticacion)
- [Tipos de código de pago](https://doc.latinpay.pe/guias/tipos-de-codigo-de-pago)
- [Cargas masivas](https://doc.latinpay.pe/guias/cargas-masivas)
- [Eliminar un cobro](https://doc.latinpay.pe/guias/eliminar-un-cobro)
- [Reintentar sin duplicar](https://doc.latinpay.pe/guias/reintentar-sin-duplicar)
- [Cuentas por cobrar](https://doc.latinpay.pe/guias/cuentas-por-cobrar)
- [Corregir los datos de un cobro y de un pagador](https://doc.latinpay.pe/guias/corregir-los-datos-de-un-cobro-y-de-un-pagador)
- [Consultar y listar tus cobros y códigos](https://doc.latinpay.pe/guias/consultar-y-listar-tus-cobros-y-codigos)
- [Cobros creados desde el Portal Comercio](https://doc.latinpay.pe/guias/cobros-creados-desde-el-portal-comercio)
- [Mora](https://doc.latinpay.pe/guias/mora)
- [Estados](https://doc.latinpay.pe/guias/estados)
- [Glosario](https://doc.latinpay.pe/guias/glosario)
- [Webhooks](https://doc.latinpay.pe/guias/webhooks)
- [Límites y tiempos](https://doc.latinpay.pe/guias/limites-y-tiempos)

## Endpoints

- `POST /api/v1/receivables` (createReceivable): Crear un cobro
- `GET /api/v1/receivables/{id}` (getReceivable): Consultar un cobro
- `PATCH /api/v1/receivables/{id}` (updateReceivable): Corregir una cuenta por cobrar
- `DELETE /api/v1/receivables/{id}` (deleteReceivable): Eliminar un cobro
- `GET /api/v1/subscriptions/{lookup_code}/receivables` (listSubscriptionReceivables): Cobros pendientes de una cuenta por cobrar
- `GET /api/v1/payment-orders/{code}` (getPaymentOrder): Consultar una orden por su código
- `POST /api/v1/payment-orders/resolve` (resolvePaymentCode): Resolver un código de pago
- `POST /api/v1/receivables/bulk-loads` (openBulkLoad): Abrir un lote de carga masiva
- `GET /api/v1/receivables/bulk-loads/{id}/items` (listBulkLoadItems): Resultado por ítem
- `POST /api/v1/receivables/bulk-loads/{id}/items` (addBulkLoadItems): Enviar ítems a un lote
- `POST /api/v1/receivables/bulk-loads/{id}/close` (closeBulkLoad): Cerrar un lote
- `GET /api/v1/receivables/bulk-loads/{id}` (getBulkLoad): Consultar un lote
- `GET /api/v1/receivables/list` (listReceivables): Listar tus cobros
- `GET /api/v1/payment-codes` (listPaymentCodes): Listar tus códigos de pago
- `GET /api/v1/payment-codes/{id}` (getPaymentCode): Consultar un código de pago
- `PATCH /api/v1/payers/{id}` (updatePayer): Corregir los datos de contacto de un pagador
- `GET /api/v1/late_fee_policies` (listLateFeePolicies): Listar tus políticas de mora
- `POST /api/v1/late_fee_policies` (createLateFeePolicy): Crear una política de mora
- `GET /api/v1/late_fee_policies/{id}` (getLateFeePolicy): Consultar una política de mora
- `PUT /api/v1/late_fee_policies/{id}` (updateLateFeePolicy): Actualizar una política de mora
- `DELETE /api/v1/late_fee_policies/{id}` (deleteLateFeePolicy): Eliminar una política de mora

## Eventos de webhook

- `payment.succeeded`: payment.succeeded — se confirmó un pago
- `payment.reversed`: payment.reversed — se revirtió un pago
- `receivable.created`: receivable.created — se creó un cobro
- `receivable.expired`: receivable.expired — venció un cobro
- `receivable.deletion_scheduled`: receivable.deletion_scheduled — eliminación programada
- `receivable.deleted`: receivable.deleted — se borró un cobro
- `receivable.cancelled`: receivable.cancelled — se desactivó un cobro
- `receivable.reactivated`: receivable.reactivated — se reactivó un código estático
- `webhook.test`: webhook.test — evento de prueba

## Cambios

- [1.0.0 (2026-11-11)](https://doc.latinpay.pe/changelog#1-0-0): Primera versión de la API de comercios