Crear Orden de Pago

Changed on Nov 3, 2026

Método para crear una orden de pago en Kashio

post/invoices

Request

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

Request body

request_datetimestring date-time required

Fecha de solicitud del sistema de la empresa (ISO-8601: yyyy-MM-ddThh:mm:ss). Timezone en GMT

currencystring required

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

amountnumber double required

Monto total de la orden de pago. Usar 2 decimales

invoice_idstring required

Número único de la deuda en los sistemas de la empresa (External ID)

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

metadatastring

Detalles adicionales a la orden de pago (formato JSON). Para valores personalizados consultar con su ejecutivo de cuentas. Ejemplo: {"order_id": "Referencia Deuda", "order_name": "Orden", "order_description": "Desc Orden"}

Response

Created

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.01,
  "created": "2022-12-29T19:50:42",
  "currency": "PEN",
  "customer": {
    "document_id": "1672343443",
    "document_type": "DNI",
    "email": "carlosvw@homatil.com",
    "external_id": "1672343443",
    "name": "Carlos VW",
    "phone": "+517776666"
  },
  "due_datetime": "2023-01-13T19:50:42",
  "expiration_datetime": "2023-01-28T19:50:42",
  "gateway_url": "https://cert-gateway.kashio.net/e/index.html?token=5vax5Bbxnia7P7AbucbQ5L",
  "id": "inv_cert_XXXXXXXXXXXXXX",
  "invoice_id": "1672343443",
  "ktin": "223635282267",
  "metadata": {
    "order_description": "Orden 1672343443",
    "order_id": "1672343443",
    "order_name": "Orden 1672343443"
  },
  "object": "invoice",
  "psp_tin": "223635282267",
  "status": "NEW",
  "sub_total": 2.01,
  "token": "5vax5Bbxnia7P7AbucbQ5L"
}

Changes

Nov 3, 20260230a81cac9f Revision changes
- breaking
  the / request property type changed from string to object
- 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 boolean for status
- breaking
  the response's property type changed from string to number for status
- info
  api operation id post_invoices removed and replaced with crear-deuda1
- info
  the endpoint scheme security BasicAuth was removed from the API
- 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