Actualizar Orden de Pago

Changed on Nov 3, 2026

Método para actualizar una orden de pago en Kashio

patch/invoices/{invoice_id}

Request

Base URL
https://cert-api.kashio.net/v1/payments
URL
https://cert-api.kashio.net/v1/payments/invoices/{invoice_id}
Auth
HTTP basic

Path parameters

invoice_idstring required

ID Kashio de la orden de pago existente

Request body

invoice_idstring required

Número único de la deuda en los sistemas de la empresa

due_datetimestring date-time

Fecha de vencimiento (ISO-8601: yyyy-MM-ddThh:mm:ss). Usado para aplicación de moras. Timezone en GMT. De no considerar este campo, el sistema por default considerará 15 días mas al request_datetime

expiration_datetimestring date-time

Fecha de expiración (ISO-8601: yyyy-MM-ddThh:mm:ss). Timezone en GMT

currencystring required

Moneda de la orden de pago (ISO-4217 - 3 dígitos)

feesnumber double

Usar 2 decimales

late_feenumber double

Usar 2 decimales

sub_totalnumber double

Sub monto de la orden de pago sin aplicacion de moras o penalidad. Usar 2 decimales

amountnumber double

Monto total de la orden de pago. Usar 2 decimales

metadatastring

Detalles adicionales a la orden de pago (formato JSON). Para valores personalizados consultar con su ejecutivo de cuentas

Response

200

amountnumber

createdstring

currencystring

due_datetimestring

expiration_datetimestring

feesinteger

gateway_urlstring

idstring

invoice_idstring

ktinstring

late_feeinteger

livemodeboolean

objectstring

psp_tinstring

statusstring

sub_totalnumber

tokenstring

Example response

{
  "amount": 2.03,
  "created": "2022-12-30T16:58:35",
  "currency": "PEN",
  "customer": {
    "document_id": "1672419515",
    "document_type": "DNI",
    "email": "carlosvw03@homatil.com",
    "name": "Carlos VW 03",
    "phone": "+517776666"
  },
  "due_datetime": "2023-01-14T16:58:35",
  "expiration_datetime": "2023-01-29T16:58:35",
  "gateway_url": "https://cert-gateway.kashio.net/e/index.html?token=Dzk8mU4X9JxWjAAH6g4jHf",
  "id": "inv_cert_XXXXXXXXXXXXXX",
  "invoice_id": "1634681942",
  "ktin": "223645286988",
  "metadata": {
    "order_description": "Orden 1672419515",
    "order_id": "1672419515",
    "order_name": "Orden 1672419515"
  },
  "object": "invoice",
  "psp_tin": "223645286988",
  "status": "NEW",
  "sub_total": 2.03,
  "token": "Dzk8mU4X9JxWjAAH6g4jHf"
}

Changes

Nov 3, 20260230a81cac9f Revision changes
- breaking
  the request property type changed from string to number, and format from no format to double
- breaking
  the / request property type changed from string to object
- breaking
  the request property format changed from no format to date-time
- breaking
  the request property format changed from no format to date-time
- breaking
  the request property type changed from string to number, and format from no format to double
- breaking
  the request property type changed from string to number, and format from no format to double
- breaking
  the response's property type changed from string to number for status
- breaking
  the response's property type changed from string to integer for status
- breaking
  the response's property type changed from string to integer for status
- breaking
  the response's property type changed from string to boolean for status
- breaking
  the response's property type changed from string to integer for status
- breaking
  the response's property type changed from string to number for status
- warning
  removed the request property
- info
  api operation id get_invoices{invoice_id} removed and replaced with actualizar-deuda
- info
  added the new optional request property
- info
  added the new enum value to the request property /
- info
  the response's property default value 0 was added for the status
- info
  the response's property default value 0 was added for the status
- info
  the response's property default value 0 was added for the status
- info
  the response's property default value true was added for the status
- info
  the response's property default value 0 was added for the status
- info
  the response's property default value 0 was added for the status

Operation history