Kuenta Docs

Appearance

Actualizar información de pago​

POST
/receivable/{creditid}/update-payment

Actualiza la información de pago de una cuenta por cobrar específica, permitiendo modificar detalles como el monto, fecha, método de pago y aplicar el pago a cuotas específicas. Útil para correcciones y ajustes.

Authorizations​

test

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://test-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
stage

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://stage-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
demo

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://demo-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
prod

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones

Parameters​

Path Parameters

creditid*

ID único del crédito a actualizar

Typestring
Required
Example123e4567-e89b-12d3-a456-426614174000
formatuuid

Request Body​

application/json
JSON
{
"paymentDate": "2024-01-25",
"amount": 275000,
"paymentMethod": "string",
"installmentNumber": 3,
"paymentType": "string",
"reference": "PAY-2024-001-XYZ789",
"notes": "Corrección de fecha de pago por transferencia bancaria",
"applyToOldest": true,
"distributionStrategy": "string",
"bankDetails": {
"bankName": "Banco de Colombia",
"accountNumber": "****5678",
"transactionId": "BCO-2024-TXN-123456",
"confirmationCode": "CONF-ABC123"
}
}

Responses​

Pago actualizado exitosamente
application/json
JSON
{
"credit": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"currentBalance": 2475000,
"status": "string",
"lastPaymentDate": "2024-01-25"
},
"paymentUpdate": {
"id": "789f0123-f450-67a8-b901-234567890abc",
"amount": 275000,
"appliedDate": "2024-01-25",
"updatedAt": "2024-01-30T17:15:00Z"
},
"installmentsAffected": [
{
"installmentNumber": 3,
"previousBalance": 275000,
"paymentApplied": 275000,
"newBalance": 0,
"status": "string"
}
],
"summary": {
"totalApplied": 275000,
"installmentsPaid": 1,
"remainingBalance": 2475000
}
}

Playground​

Server
Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI