createInvoiceLink

Categoría: Pagos · Bot API 10.3 · Documentación oficial

Crea un enlace de pago.

Devuelve: Si la llamada tiene éxito, devuelve String.

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
`business_connection_id`	`String`	Opcional	ID de la conexión empresarial
`title`	`String`	Sí	Título del producto
`description`	`String`	Sí	Descripción del producto
`payload`	`String`	Sí	Payload de la factura
`provider_token`	`String`	Opcional	Token del proveedor de pagos
`currency`	`String`	Sí	Moneda
`prices`	`Array of LabeledPrice`	Sí	Array JSON de LabeledPrice
`subscription_period`	`Integer`	Opcional	Período de suscripción en segundos
`max_tip_amount`	`Integer`	Opcional	Monto máximo de propina
`suggested_tip_amounts`	`Array of Integer`	Opcional	Array JSON de montos de propina sugeridos
`provider_data`	`String`	Opcional	Datos JSON para el proveedor
`photo_url`	`String`	Opcional	URL de la foto del producto
`photo_size`	`Integer`	Opcional	Tamaño de la foto
`photo_width`	`Integer`	Opcional	Ancho de la foto
`photo_height`	`Integer`	Opcional	Alto de la foto
`need_name`	`Boolean`	Opcional	Solicitar el nombre
`need_phone_number`	`Boolean`	Opcional	Solicitar el teléfono
`need_email`	`Boolean`	Opcional	Solicitar el correo electrónico
`need_shipping_address`	`Boolean`	Opcional	Solicitar la dirección de envío
`send_phone_number_to_provider`	`Boolean`	Opcional	Enviar el teléfono al proveedor
`send_email_to_provider`	`Boolean`	Opcional	Enviar el correo electrónico al proveedor
`is_flexible`	`Boolean`	Opcional	Precio flexible

Las descripciones de los parámetros son resúmenes breves; consulta la documentación oficial para ver el texto completo.

Ejemplo de solicitud

curl

curl -s -X POST "https://api.telegram.org/bot$TOKEN/createInvoiceLink" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Example",
  "description": "Example item",
  "payload": "order-1",
  "currency": "XTR",
  "prices": [
    {
      "label": "Item",
      "amount": 100
    }
  ]
}'

Python

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
    f"https://api.telegram.org/bot{TOKEN}/createInvoiceLink",
    json={
        "title": "Example",
        "description": "Example item",
        "payload": "order-1",
        "currency": "XTR",
        "prices": [
            {
                "label": "Item",
                "amount": 100
            }
        ]
    },
    timeout=30,
)
print(resp.json())

JavaScript

const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/createInvoiceLink`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "title": "Example",
    "description": "Example item",
    "payload": "order-1",
    "currency": "XTR",
    "prices": [
      {
        "label": "Item",
        "amount": 100
      }
    ]
  }),
});
console.log(await res.json());

Guía paso a paso: Cómo crear un bot en Telegram paso a paso: de BotFather a tu primer mensaje

sendInvoiceEnvía una factura para su pago.
refundStarPaymentReembolsa un pago en Telegram Stars.
sendGiftEnvía un regalo a un usuario o chat.
getMyStarBalanceDevuelve el saldo de Telegram Stars del bot.
getStarTransactionsDevuelve las transacciones de Telegram Stars del bot.
editUserStarSubscriptionCancela o renueva una suscripción de Telegram Stars.
giftPremiumSubscriptionRegala una suscripción a Telegram Premium.
answerShippingQueryResponde a una consulta de envío.
answerPreCheckoutQueryResponde a una consulta previa al pago.
getAvailableGiftsDevuelve los regalos disponibles que el bot puede enviar.
getUserGiftsDevuelve los regalos de un usuario.
getChatGiftsDevuelve los regalos de un chat.