# Create payment

Create a payment in Khipu and obtain the URLs to redirect the user to complete the payment.

Endpoint: POST /2.0/payments
Version: v2.0
Security: 

## Request fields (application/x-www-form-urlencoded):

  - `amount` (number, required)
    The amount of the charge. Without thousands separator and using '.' as decimal separator. Up to 4 decimal places, depending on currency.
    Example: 1000

  - `currency` (string, required)
    The currency code in ISO-4217 format. The currencies available for payment will depend on the country configured for the merchant.
    Enum: "CLP", "ARS", "PEN", "MXN", "USD", "EUR", "BOB", "COP"

  - `subject` (string, required)
    Text to summarize the charge.
    Example: "Cobro de prueba"

  - `transaction_id` (string)
    Transaction's identifier. Ex: invoice or purchase order number.
    Example: "zwo3wqz6uulcvajt"

  - `custom` (string)
    Parameter to send personalized transaction information. Ex: XML document with the shopping cart details.
    Example: "<xml>...</xml>"

  - `body` (string)
    Description of the charge.
    Example: "Cobro de orden de compra #123-abcdef"

  - `bank_id` (string)
    Bank identifier to use in the payment.
    Example: "SDdGj"

  - `return_url` (string)
    The URL to send the customer to while the payment is being verified.
    Example: "https://micomercio.com/order/return_url"

  - `cancel_url` (string)
    The URL to send the customer to if they decide not to make the transaction.
    Example: "https://micomercio.com/order/cancel_url"

  - `picture_url` (string)
    A URL of a photo of your product or service.
    Example: "https://micomercio.com/picture_url"

  - `notify_url` (string)
    The address of the web-service that khipu will use to notify when the payment is reconciled.
    Example: "https://micomercio.com/webhook/notify_url"

  - `contract_url` (string)
    The URL address of the PDF file with the contract to be signed through this payment. The merchant must be enabled for this service and the  field is required.
    Example: "https://micomercio.com/contract_url"

  - `notify_api_version` (string)
    Version of the notifications API to receive notifications by web-service.
    Example: "3.0"

  - `expires_date` (string)
    Maximum date to execute the payment (in ISO-8601 format). The client may make several payment attempts until said date. Each attempt has an individual period of 3 hours for its execution.
    Example: "2023-12-31T15:45:00-04:00"

  - `send_email` (boolean)
    If , a collection request will be sent to the email specified in .

  - `payer_name` (string)
    Payer's name. It is required when  is .
    Example: "Nombre Pagador"

  - `payer_email` (string)
    Payer's email. Required when  is .
    Example: "pagador@email.com"

  - `send_reminders` (boolean)
    If , collection reminders will be sent.
    Example: true

  - `responsible_user_email` (string)
    Email of the person responsible for this collection, must correspond to a khipu user with permissions to collect using this collection account.
    Example: "responsible@email.com"

  - `fixed_payer_personal_identifier` (string)
    Personal identifier. If specified, payment can only be made using that identifier.
    Example: "11.000.111-9"

  - `integrator_fee` (string)
    Fee for the integrator. It is only valid if the collection account has an associated integrator account.
    Example: "100"

  - `collect_account_uuid` (string)
    For collection accounts with more own account. Allows you to choose the account where the transfer should occur.
    Example: "007367340234"

  - `confirm_timeout_date` (string)
    Collection submission date. It is also the final date to be able to refund the charge. ISO-8601 format.
    Example: "2017-03-01T13:00:00Z"

  - `mandatory_payment_method` (string)
    The charge can only be paid using the specified payment method. Possible values for this field are found in the  field of the response from the  endpoint.
    Example: "simplified_transfer"

  - `psp_client_merchant_name` (string)
    Name of the end merchant for whom a Payment Service Provider is processing a payment. Required for PSP client transactions; not applicable for others.
    Example: "Client Name"

## Response 200 fields (application/json):

  - `payment_id` (string, required)
    Unique identifier of the payment, it is a 12-character alphanumeric string. Because this identifier is unique, it can be used, for example, to avoid processing a repeated notification. (Khipu waits for a code 200 when notifying a payment, if this does not occur it retries for up to two days).
    Example: "gqzdy6chjne9"

  - `payment_url` (string, required)
    Main payment URL, if the user has not previously chosen a payment method, the options are shown.
    Example: "https://khipu.com/payment/info/gqzdy6chjne9"

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

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

  - `app_url` (string, required)
    URL to invoke payment from a mobile device using the Khipu APP.
    Example: "khipu:///pos/gqzdy6chjne9"

  - `ready_for_terminal` (boolean, required)
    It is  if the payment already has all the necessary data to directly open the Khipu payment application.