---
title: "Crear una intención de pago"
method: POST
path: "/payment"
tags: ["API de PinPad"]
---

# Crear una intención de pago

`POST /payment`

## Request

- Base URL: `https://api.payclip.io/f2f/pinpad/v1`
- URL: `https://api.payclip.io/f2f/pinpad/v1/payment`
- Auth: API key in header `Authorization`

Crea una intención de pago en un dispositivo PinPad registrado en tu cuenta Clip.

## Request body

- object
  - `amount` number, float, required: Monto de la transacción.
  - `tip_amount` number, float: Monto de la propina.
  - `reference` string, required: ID de referencia externa.
  - `serial_number_pos` string, required: Número de serie del Lector Clip.
  - `webhook_url` string, uri: URL del endpoint que recibirá notificaciones webhook del link de pago. Puedes consultar la estructura de la notificación webhook en el siguiente [link](https://developer.clip.mx/reference/webhook).
  - `preferences` object: Valores personalizables.
    - `is_auto_return_enabled` boolean
    - `is_tip_enabled` boolean
    - `is_msi_enabled` boolean
    - `is_mci_enabled` boolean
    - `is_dcc_enabled` boolean
    - `is_retry_enabled` boolean
    - `is_share_enabled` boolean
    - `is_auto_print_receipt_enabled` boolean
    - `is_split_payment_enabled` boolean
    - `redirect_package_name` string
    - `tip_options` number[]

## Response `200`

OK

- object
  - `pinpad_request_id` string: Identificador de la solicitud en PinPad.
  - `reference` string: ID de referencia externa del pago.
  - `amount` string: Monto de la transacción.
  - `serial_number_pos` string: Número de serie del Lector Clip.

## Other responses

- `400`: Error al conectar con el terminal

---

[API](https://skmtc.dev/clip/apis/clip-pinpad-api-paid.md) - [All operations](https://skmtc.dev/clip/apis/clip-pinpad-api-paid/llms.txt) - [OpenAPI document](https://skmtc.dev/clip/apis/clip-pinpad-api-paid/revisions/d717cc4fb7d8?raw)