# Create payment

Crea un pago en Khipu y obtiene las URLs para redirección al usuario para que complete el pago.

Endpoint: POST /v3/payments
Version: v3.0
Security: Api-Key

## Request fields (application/json):

  - `amount` (number, required)
    El monto del cobro. Sin separador de miles y usando '.' como separador de decimales. Hasta 4 lugares decimales, dependiendo de la moneda.
    Example: 1000

  - `currency` (string, required)
    El código de moneda en formato ISO-4217.
    Enum: "CLP", "CLF", "ARS", "PEN", "MXN", "USD", "EUR", "BOB", "COP"

  - `subject` (string, required)
    Motivo.
    Example: "Cobro de prueba"

  - `transaction_id` (string)
    Identificador propio de la transacción. Ej: número de factura u orden de compra.
    Example: "zwo3wqz6uulcvajt"

  - `custom` (string)
    Parámetro para enviar información personalizada de la transacción. Ej: documento XML con el detalle del carro de compra.
    Example: "<xml>...</xml>"

  - `body` (string)
    Descripción del cobro.
    Example: "Cobro de orden de compra #123-abcdef"

  - `bank_id` (string)
    Identificador del banco para usar en el pago.
    Example: "SDdGj"

  - `return_url` (string)
    La dirección URL a donde enviar al cliente mientras el pago está siendo verificado.
    Example: "https://micomercio.com/order/return_url"

  - `cancel_url` (string)
    La dirección URL a donde enviar al cliente si decide no hacer hacer la transacción.
    Example: "https://micomercio.com/order/cancel_url"

  - `picture_url` (string)
    Una dirección URL de una foto de tu producto o servicio.
    Example: "https://micomercio.com/picture_url"

  - `notify_url` (string)
    La dirección del web-service que utilizará khipu para notificar cuando el pago esté conciliado.
    Example: "https://micomercio.com/webhook/notify_url"

  - `contract_url` (string)
    La dirección URL del archivo PDF con el contrato a firmar mediante este pago. El cobrador debe estar habilitado para este servicio y el campo  es obligatorio.
    Example: "https://micomercio.com/contract_url"

  - `notify_api_version` (string)
    Versión de la API de notificaciones para recibir avisos por web-service.
    Example: "3.0"

  - `expires_date` (string)
    Fecha máxima para ejecutar el pago (en formato ISO-8601). El cliente podrá realizar varios intentos de pago hasta dicha fecha. Cada intento tiene un plazo individual de 3 horas para su ejecución.
    Example: "2023-12-31T15:45:00-04:00"

  - `send_email` (boolean)
    Si es , se enviará una solicitud de cobro al correo especificado en .

  - `payer_name` (string)
    Nombre del pagador. Es obligatorio cuando  es .
    Example: "Nombre Pagador"

  - `payer_email` (string)
    Correo del pagador. Es obligatorio cuando  es .
    Example: "pagador@email.com"

  - `send_reminders` (boolean)
    Si es , se enviarán recordatorios de cobro.
    Example: true

  - `responsible_user_email` (string)
    Correo electrónico del responsable de este cobro, debe corresponder a un usuario Khipu con permisos para cobrar usando esta cuenta de cobro.
    Example: "responsible@email.com"

  - `fixed_payer_personal_identifier` (string)
    Identificador personal. Si se especifica, solo podrá ser pagado usando ese identificador.
    Example: "11.000.111-9"

  - `integrator_fee` (string)
    Comisión para el integrador. Sólo es válido si la cuenta de cobro tiene una cuenta de integrador asociada.
    Example: "100"

  - `collect_account_uuid` (string)
    Para cuentas de cobro con más cuenta propia. Permite elegir la cuenta donde debe ocurrir la transferencia.
    Example: "007367340234"

  - `confirm_timeout_date` (string)
    Fecha de rendición del cobro. Es también la fecha final para poder reembolsar el cobro. Formato ISO-8601.
    Example: "2017-03-01T13:00:00Z"

  - `mandatory_payment_method` (string)
    El cobro sólo se podrá pagar utilizando el medio de pago especificado. Los posibles valores para este campo se encuentran en el campo  de la respuesta del endpoint .
    Example: "simplified_transfer"

  - `psp_client_merchant_name` (string)
    Nombre del comercio final para quien un proveedor de servicios de pago procesa un pago. Requerido para transacciones de clientes PSP; no aplicable para otros. En caso de tratarse de un PSP de PSP, estos deben ingresarse separados por '->'.
    Example: "PSP 1->PSP 2->Client Name"

## Response 200 fields (application/json):

  - `payment_id` (string, required)
    Identificador único del pago, es una cadena alfanumérica de 12 caracteres. Como este identificador es único, se puede usar, por ejemplo, para evitar procesar una notificación repetida. (Khipu espera un código 200 al notificar un pago, si esto no ocurre se reintenta hasta por dos días).
    Example: "gqzdy6chjne9"

  - `payment_url` (string, required)
    URL principal del pago, si el usuario no ha elegido previamente un método de pago se le muestran las opciones.
    Example: "https://khipu.com/payment/info/gqzdy6chjne9"

  - `simplified_transfer_url` (string, required)
    URL de pago simplificado.
    Example: "https://app.khipu.com/payment/simplified/gqzdy6chjne9"

  - `transfer_url` (string, required)
    URL de pago normal.
    Example: "https://khipu.com/payment/manual/gqzdy6chjne9"

  - `app_url` (string, required)
    URL para invocar el pago desde un dispositivo móvil usando la APP de Khipu.
    Example: "khipu:///pos/gqzdy6chjne9"

  - `ready_for_terminal` (boolean, required)
    Es  si el pago ya cuenta con todos los datos necesarios para abrir directamente la aplicación de pagos Khipu.