---
title: "Crear Orden de Transferencia"
method: POST
path: "/invoices"
---

# Crear Orden de Transferencia

`POST /invoices`

## Request

- Base URL: `https://cs0-api.kashio.com.pe/v2/payouts`
- URL: `https://cs0-api.kashio.com.pe/v2/payouts/invoices`
- Auth: HTTP basic

Método para crear una orden de transferencia en Kashio

## Request body

- object
  - `customer` object, required: Objeto cliente
    - `external_id` string, required: Id único de cliente en los sistemas de la empresa
    - `name` string, required: Nombre completo del cliente
    - `phone` string: Teléfono de cliente en formato E.164
    - `email` string, required: Correo electrónico de cliente. Puede ser nulo
    - `document_type` '' | 'DNI' | 'RUC' | 'CEX' | 'OTHER', required: Tipo de documento DNI, RUC, CEX, OTHER
    - `document_id` string, required: Número de documento del cliente. No incluir caracteres especiales (-, /, &, $, #, entre otros) ni espacios en blanco
    - `address` object: Dirección de cliente
      - `street` string: Direccion
      - `county` string: Condado
      - `zip` string: Código postal
      - `city` string: Ciudad
      - `state` string: Estado
    - `accounts` object[]: Datos de cuenta bancaria de cliente. Objecto requerido
      - `bank` object: Entidad bancaria a utilizar para la transferencia. Objeto requerido
        - `id` string, required: Id de la entidad financiera. Revisar lista de entidades financieras en Kashio
      - `account_number` string, required: Número de la cuenta de cliente en la entidad bancaria
      - `type` '' | 'MASTER' | 'SAVING' | 'CHECKING' | 'SIGHT', required: Tipo de cuenta del cliente: PERU usar MASTER, SAVING o CHECKING; CHILE: SIGHT
      - `cci` string, required: Código interbanciario de cuenta de cliente
  - `external_id` string, required: Id único de la orden de transferencia. Lado empresa
  - `request_datetime` string, date, required: Fecha de solicitud del sistema de la empresa (ISO-8601: yyyy-MM-ddThh:mm:ss). Timezone en GMT. Puede ser nulo
  - `due_datetime` string, date: 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_datetime` string, date: Fecha de expiración (ISO-8601: yyyy-MM-ddThh:mm:ss). Timezone en GMT
  - `total` object, required: Moneda y monto total de la orden de transferencia. Usar 2 decimales
    - `currency` string, required: Moneda de la orden de transferencia (ISO-4217 - 3 dígitos)
    - `value` number, double, required: Monto total de la orden de transferencia. Usar 2 decimales
  - `metadata` string: Detalles adicionales a la orden de transferencia (formato JSON). Para comercios del MX, se deben colocar 2 campos obligatorios: latitude y longitude

## Response `200`

200

- object
  - `created` string
  - `customer` object
    - `id` string
    - `name` string
  - `description` string
  - `external_id` string
  - `id` string
  - `late_fee` object
    - `currency` string
    - `symbol` string
    - `value` integer
  - `livemode` boolean
  - `metadata` object
    - `metadata` object
      - `accounts` object[]
        - `account_number` string
        - `bank` object
          - `id` string
        - `cci` string
        - `id` string
        - `type` string
    - `order_description` string
    - `order_id` string
    - `order_name` string
    - `payout_batch` object
      - `external_id` string
  - `name` string
  - `object` string
  - `reference` string
  - `status` string
  - `sub_total` object
    - `currency` string
    - `symbol` string
    - `value` number
  - `total` object
    - `currency` string
    - `symbol` string
    - `value` number

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/kashio/apis/api-pagos-masivos-20.md) - [All operations](https://skmtc.dev/kashio/apis/api-pagos-masivos-20/llms.txt) - [OpenAPI document](https://skmtc.dev/kashio/apis/api-pagos-masivos-20/revisions/a2daf4df287b?raw)