---
title: "Create Unique Payment Link"
method: POST
path: "/checkouts"
tags: ["Payment Link"]
---

# Create Unique Payment Link

`POST /checkouts`

## Headers

- `Accept-Language` 'es' | 'en'
- `X-Child-Company-Id` string

## Request body

- Checkout — It is a sub-resource of the Order model that can be stipulated in order to configure its corresponding checkout
  - `allowed_payment_methods` string[] — Those are the payment methods that will be available for the link. This field is mutually exclusive with excluded_payment_methods.
  - `excluded_payment_methods` string[] — Payment methods to be excluded from the checkout. This field is mutually exclusive with allowed_payment_methods.
  - `exclude_card_networks` string[] — List of card networks to exclude from the checkout. This field is only applicable for card payments.
  - `expires_at` integer, required — It is the time when the link will expire. It is expressed in seconds since the Unix epoch. The valid range is from 5 minutes to 365 days from the creation date.
  - `monthly_installments_enabled` boolean — This flag allows you to specify if months without interest will be active.
  - `monthly_installments_options` integer[] — This field allows you to specify the number of months without interest.
  - `three_ds_mode` string, nullable — Indicates the 3DS2 mode for the order, either smart or strict. This property is only applicable when 3DS is enabled. When 3DS is disabled, this field should be null.
  - `name` string, required — Reason for charge
  - `needs_shipping_contact` boolean — This flag allows you to fill in the shipping information at checkout.
  - `on_demand_enabled` boolean, nullable — This flag allows you to specify if the link will be on demand.
  - `plan_ids` string[] — It is a list of plan IDs that will be associated with the order.
  - `order_template` CheckoutOrderTemplate, required — It maintains the attributes with which the order will be created when receiving a new payment.
    - `currency` string, required — It is the currency in which the order will be created. It must be a valid ISO 4217 currency code.
    - `customer_info` union — It is the information of the customer who will be created when receiving a new payment.
      - CustomerInfo
        - `name` string, required
        - `email` string, email, required
        - `phone` string, required
        - `corporate` boolean
        - `object` string
      - CustomerInfoCustomerId
        - `customer_id` string, required
    - `line_items` Product[], required — They are the products to buy. Each contains the "unit price" and "quantity" parameters that are used to calculate the total amount of the order.
      - `antifraud_info` object
      - `brand` string — The brand of the item.
      - `description` string — Short description of the item
      - `metadata` object — It is a key/value hash that can hold custom fields. Maximum 100 elements and allows special characters.
      - `name` string, required — The name of the item. It will be displayed in the order.
      - `quantity` integer, required — The quantity of the item in the order.
      - `sku` string — The stock keeping unit for the item. It is used to identify the item in the order.
      - `tags` string[] — List of tags for the item. It is used to identify the item in the order.
      - `unit_price` integer, required — The price of the item in cents.
    - `metadata` object — It is a set of key-value pairs that you can attach to the order. It can be used to store additional information about the order in a structured format.
    - `tax_lines` OrderTaxRequest[] — List of [taxes](https://developers.conekta.com/v2.3.0/reference/orderscreatetaxes) that are applied to the order.
      - `amount` integer, required — The amount to be collected for tax in cents
      - `description` string, required — description or tax's name
      - `metadata` object
    - `discount_lines` OrderDiscountLinesRequest[] — List of [discounts](https://developers.conekta.com/v2.3.0/reference/orderscreatediscountline) that are applied to the order.
      - `amount` integer, required — The amount to be deducted from the total sum of all payments, in cents.
      - `code` string, required — Discount code.
      - `type` string, required — It can be 'loyalty', 'campaign', 'coupon' o 'sign'
  - `payments_limit_count` integer — It is the number of payments that can be made through the link.
  - `success_url` string — The URL to redirect to after a successful payment.
  - `recurrent` boolean, required — false: single use. true: multiple payments
  - `type` string, required — It is the type of link that will be created. It must be a valid type.

## Response `200`

successful operation

## Other responses

- `401` — authentication error
- `402` — payment required error
- `422` — parameter validation error
- `500` — internal server error

---

[API](https://skmtc.net/conekta/apis/conekta-api.md) · [All operations](https://skmtc.net/conekta/apis/conekta-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conekta/conekta-api/revisions/029df3052bca/schema)