🚀 Lanzamiento v2.3: Activa y desactiva métodos de pago para tu Conekta Checkout desde el Panel, sin tocar tu código. Ver documentación →

Links de Pago con suscripciones

Suscripciones en nuestro Componente

Suscripciones en nuestro Componente


En esta sección abarcaremos como crear links de pago con planes para suscripciones por medio de:

  1. API
  2. Conekta Panel

Creando links de pago con suscripciones por API

1. Crea un plan:

Crea un plan a través de nuestro API de planes

curl --request POST 'https://api.conekta.io/plans' \
--header 'Accept: application/vnd.conekta-v2.3.0+json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer key_xxxxxxxxxxxxxx' \
--data-raw '{
	"amount": 1000000,
  "currency": "MXN",
  "expiry_count": 1,
  "frequency": 2,
  "id": "nuevo-plan",
  "interval": "week",
  "name": "Nuevo plan",
  "trial_period_days": 0,
  "max_retries": 3,
  "retry_delay_hours": 50
}
'
{
  "id": "nuevo-plan",
  "livemode": false,
  "created_at": 1743712372,
  "name": "Nuevo plan",
  "amount": 1000000,
  "currency": "MXN",
  "interval": "week",
  "frequency": 2,
  "expiry_count": 1,
  "trial_period_days": 0,
  "max_retries": 3,
  "retry_delay_hours": 50,
  "object": "plan"
}

En caso de ya tener un plan creado con anterioridad puedes simplemente usar el plan_id

2. Crea un link de pago con planes para una suscripción

Al momento de crear un link de pago debes enviar el parámetro plan_ids, que corresponde a una lista de identificadores de planes que deseas habilitar para tus clientes en una suscripción. Esta lista puede contener uno o varios IDs. Además, debes asegurarte de establecer la propiedad needs_shipping_contact en false.

ℹ️

Las suscripciones solo son compatibles con el método de pago Tarjeta. Asegúrate de tener habilitado el método de pago Tarjeta en tu Conekta Panel, en la sección de métodos de pago, antes de realizar pruebas.

curl --request POST 'https://api.conekta.io/checkouts' \
--header 'Accept: application/vnd.conekta-v2.3.0+json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer key_xxxxxxxxxxxxxx' \
--data-raw '{
  "name": "Payment Link Testing",
  "type": "PaymentLink",
  "recurrent": false,
  "expires_at": 1745331574,
  "plan_ids": ["plan-test"],
  "needs_shipping_contact": false,
  "order_template": {
    "line_items": [
      {
        "name": "Producto test",
        "unit_price": 1000,
        "quantity": 10
      }
    ],
    "currency": "MXN",
    "customer_info": {
      "name": "Test",
      "email": "[email protected]",
      "phone": "5244444444"
    },
    "metadata": {
      "external_customer_id": "customer_id"
    }
  }
}'
{
	"id": "1234asdf-1234-asdf-1234-asdf1234",
  "name": "Payment Link Testing",
  "livemode": false,
  "emails_sent": 0,
  "success_url": "",
  "failure_url": "",
  "paid_payments_count": 0,
  "sms_sent": 0,
  "status": "Issued",
  "type": "PaymentLink",
  "recurrent": false,
  "starts_at": 1234123400,
  "expires_at": 1234123400,
  "allowed_payment_methods": ["card"],
  "exclude_card_networks": [],
  "needs_shipping_contact": true,
  "monthly_installments_options": [],
  "monthly_installments_enabled": false,
  "force_3ds_flow": false,
  "metadata": {
  	"external_customer_id": "customer_id"
  },
  "can_not_expire": false,
  "object": "checkout",
  "is_redirect_on_failure": false,
  "slug": "123412341234123412asdf2",
  "url": "https://pay.conekta.com/link/123412341234123412asdf2"
}

Creando links de pago con suscripciones por Panel en 1 minuto

👍

Crea planes en esta misma página

En caso de no tener planes creados con anterioridad, puedes crearlos en esta misma página de creacion de Link de pago a través del botón Crear nuevo plan

Suscripciones en nuestro Componente

Crea un link de pago con suscripciones en la sección de Link de Pago > Crear link


Did this page help you?