---
title: "Crear"
method: POST
path: "/setup_intents"
tags: ["Setup Intents"]
---

# Crear

`POST /setup_intents`

## Request

- Base URL: `https://api.ventipay.com/v1`
- URL: `https://api.ventipay.com/v1/setup_intents`
- Auth: HTTP bearer

Crea un nuevo objeto `SetupIntent`. Una vez creada la intención, el cliente podrá inscribir un método de pago en la URL indicada por el objeto.

## Request body

- object
  - `customer_id` string: ID de `Customer`. Debe enviarse customer_id o customer_email.
  - `customer_email` string: Email de `Customer`. Si no existe, se creará. Debe enviarse customer_id o customer_email.
  - `metadata` string, json: Conjunto de pares llave-valor asociado al objeto.
  - `notification_events` string[]: setup_intent.created, setup_intent.succeeded, setup_intent.expired, setup_intent.canceled
  - `notification_url` string
  - `success_url` string: Una URL a la cual el cliente será redirigido al inscribir un método de pago exitosamente.
  - `success_url_method` 'get' | 'post'
  - `cancel_url` string: Una URL a la cual el cliente será redirigido para volver al comercio.
  - `cancel_url_method` 'get' | 'post'

---

[API](https://skmtc.dev/ventipay/apis/payment-methods.md) - [All operations](https://skmtc.dev/ventipay/apis/payment-methods/llms.txt) - [OpenAPI document](https://skmtc.dev/ventipay/apis/payment-methods/revisions/802fd991cef8?raw)