---
title: "Crear un nuevo link de pago"
method: POST
path: "/checkout"
tags: ["Checkout"]
---

# Crear un nuevo link de pago

`POST /checkout`

Genera un link de pago para redirigir a tus clientes al servicio de Checkout de Clip en donde pueden completar su pago de manera segura y rápida.

## Request body

- object
  - `amount` number, float, required — Número con decimales que representa el monto a cobrar. El número mínimo entero es 1. Utiliza dos decimales como máximo.
  - `currency` string, required — Código de tres caracteres que representa la moneda. <br/>**Formato** ISO 4217 (3 caracteres en mayúsculas).
  - `purchase_description` string, utf-8, required — Texto que describe la compra. Visible para el cliente en la UI o el recibo. <br/>**Formato** UTF-8 <br/> Se aceptan los siguientes caracteres especiales `~!@#$%^&*()\\=+\\\\|\\[{\\]};:\"<>/?
  - `redirection_url` object, required — URLs para regresar a la tienda en línea después de completar una acción.
    - `success` 'https://my-website.com/redirection/success?me_reference_id=OID123456789', required — URL cuando el pago es exitoso.
    - `error` 'https://my-website.com/redirection/error?me_reference_id=OID123456789', required — URL cuando 5 o más intentos han fallado.
    - `default` 'https://my-website.com/redirection/default', required — URL de la tienda en línea.
  - `expires_at` string, YYYY-MM-DDTHH-MM-SSZ — Indica la fecha y hora (en UTC) de expiración de la solicitud de pago, la cual debe debe ser mayor a 00:01:00 minuto de la hora de creación de la solicitud y menor a las 23:59:59 (hora de CDMX) del mismo día de creación. Ejemplo 2023-06-18T22:52:26Z <br/> Si no se especifica, el valor default de este parámetro es tres días a partir de la hora de creación.
  - `metadata` object — Objeto que puedes utilizar para identificar la transacción.<br/> El conjunto de parejas llave:valor lo puede definir el desarrollador. El objeto se almacena como una cadena de texto (JSON) sin formato de estructura.<br/> **Este objeto es opcional, los elementos me_reference_id y customer_info se muestran como ejemplo.**
    - `me_reference_id` string — ID de referencia de la orden para rastrear las transacciones. Caracteres especiales permitidos Guión medio (-) y Guión bajo (_). <br/>Se permiten acentos. <br/>Los espacios en blanco serán removidos.<br/>**Este parámetro es un ejemplo de lo que puedes incluir dentro del objeto metadata**
    - `customer_info` object — Objeto con la información del cliente para el link de pago. **El valor de este parámetro se motrará pre-llenado en el Checkout.**
      - `name` string — Nombre de tu cliente.
      - `email` string — Correo electrónico de tu cliente.
      - `phone` number — Número telefónico de tu cliente.
    - `billing_address` object — Objeto con la dirección de facturación.<br/> Solo aplica para pagos con AMEX.Si se incluye se mostrará pre-llenado en el Checkout.<br/> **Este objeto es opcional.**
      - `zip_code` string — Código postal. <br/>Los caracteres especiales permitidos son Guión medio (-) y punto (.) <br>Se permiten caracteres alfanuméricos [0-9] [a-Z] .<br/>**Este elemento es opcional.** Si se incluye se mostrará pre-llenado en el Checkout para transacciones con AMEX.
      - `locality` string — Colonia.<br/> Los caracteres especiales permitidos son Guión medio (-) y espacios.<br/>**Este elemento es opcional.** Si se incluye se mostrará pre-llenado en el Checkout para transacciones con AMEX.
      - `city` string — Delegación o municipio. <br/> Los caracteres especiales permitidos son Guión medio (-) y espacios. <br/>Se permiten acentos.<br/>**Este elemento es opcional.** Si se incluye se mostrará pre-llenado en el Checkout para transacciones con AMEX.
      - `State` string — Estado. <br/> Los caracteres especiales permitidos son Guión medio (-) y espacios. <br/>Se permiten acentos.**Este elemento es opcional.** Si se incluye se mostrará pre-llenado en el Checkout para transacciones con AMEX.
      - `country` string — País. <br/> Los caracteres especiales permitidos son Guión medio (-) y espacios. <br/>Se permiten acentos.<br/>**Este elemento es opcional.** Si se incluye se mostrará pre-llenado en el Checkout para transacciones con AMEX.
      - `street` string — Nombre de la calle. <br/> Los caracteres especiales permitidos son Guión medio (-) y espacios.<br/>**Este elemento es opcional.** Si se incluye se mostrará pre-llenado en el Checkout para transacciones con AMEX.
      - `outdoor_number` string — Número exterior del domicilio.<br/> Los caracteres especiales permitidos son Guión medio (-) y espacios.<br/>**Este elemento es opcional.** Si se incluye se mostrará pre-llenado en el Checkout para transacciones con AMEX.
      - `interior_number` string — Número interior del domicilio. <br/> Los caracteres especiales permitidos son Guión medio (-) y espacios.**Este elemento es opcional.** Si se incluye se mostrará pre-llenado en el Checkout para transacciones con AMEX.
      - `reference` string — Referencia del domicilio.<br/> Los caracteres especiales permitidos son Guión medio (-) y espacios.<br/>**Este elemento es opcional.** Si se incluye se mostrará pre-llenado en el Checkout para transacciones con AMEX.
      - `between_streets` string — Entre calles que rodean al domicilio. <br/> Los caracteres especiales permitidos son Guión medio (-) y espacios.<br/>**Este elemento es opcional.** Si se incluye se mostrará pre-llenado en el Checkout para transacciones con AMEX.
      - `floor` string — Número de piso del domicilio.<br/> Los caracteres especiales permitidos son Guión medio (-) y espacios. <br/>**Este elemento es opcional.** Si se incluye se mostrará pre-llenado en el Checkout para transacciones con AMEX.
  - `override_settings` object — Objeto que puedes utilizar para cambiar la configuración por default del Checkout.<br/>**Este objeto es opcional, si no se envía el payment_method se usará el valor por default.**
    - `payment_method` string[] — Métodos de pago aceptados en el link de pago.<br/> Los valores aceptados son ["CARD"],["CASH"] o ambos. El valor por default es ["CARD","CASH"].<br/>**Este parámetro es opcional, si no se envía se usará el valor por default.**
    - `enable_tip` boolean — Muestra u oculta las propinas. El valor por default es false.<br/>Si enabled es true se mostrarán las propinas. Si enabled es false se ocultarán las propinas.<br/>**Este parámetro es opcional, si no se envía se usará el valor por default.**
    - `locale` 'es-MX' | 'en-US' — Selecciona el idioma de la página de Checkout Clip donde el cliente completa el pago. Utiliza _es-MX_ para español o _en-US_ para inglés. <br/> El valor default es es-MX. Este parámetro es opcional, si no se envía en la solicitud se utilizará el valor default. Acepta mayúsculas y minúsculas.
    - `currency` object — Objeto que contiene la información del tipo de moneda.<br/>
      - `show_currency_code` boolean — Muestra u oculta el tipo de moneda. El valor por default es false.<br/>Si enabled es true se mostrará el tipo de moneda "MXN". Si enabled es false se ocultará el tipo de moneda.<br/>**Este parámetro es opcional, si no se envía se usará el valor por default.**
  - `webhook_url` string — URL del endpoint que recibirá notificaciones webhook del link de pago.<br/>Puedes consultar la estructura de la notificación webhook en el siguiente [link](https://developer.clip.mx/reference/checkout-webhook).

## Response `200`

OK

## Other responses

- `400` — Solicitud incorrecta
- `401` — Error de Autorización
- `403` — Prohibido
- `404` — No Encontrada
- `412` — Límite de solicitudes alcanzado
- `500` — Error de Servidor Interno

---

[API](https://skmtc.dev/clip/apis/api-de-checkout.md) · [All operations](https://skmtc.dev/clip/apis/api-de-checkout/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clip/api-de-checkout/revisions/98e2b099dab5/schema)