/
Enviar Fatura / Send Invoice

Enviar Fatura / Send Invoice

Use este bloco para enviar uma fatura para um usuário. Para mais detalhes, acesse a documentação oficial. 

 

Para utilizar este bloco, é preciso ter o plugin Telegram Bot instalado no seu projeto. Acesse a documentação do Cronapp Plugin Telegram Bot para mais detalhes. Também será necessário utilizar bots de pagamentos.

Figura 1 - Bloco Enviar Fatura

Compatibilidade

  • Bloco servidor: cronapp.framework.telegram.BotOperations.sendInvoice()

Retorno

Retorna um objeto JSON contendo informações do bot, cliente e dados sobre a fatura.

Parâmetros

Bot Token

Obrigatório. Chave de acesso exclusiva que identifica o seu bot junto à API do Telegram.

  • Posição: 1

  • Inglês: Bot Token

  • Tipo: Texto / String 

  • Exemplo: "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz1234567890"

Chat ID

Obrigatório. ID do usuário que receberá a fatura. Para obter o id dos usuários que se comunicaram com o bot, utilize o bloco Obter Atualizações / Get Updates.

  • Posição: 2

  • Inglês: Chat Id

  • Tipo: Inteiro / Integer ou Texto / String 

  • Exemplo: "1235862828"

Descrição

Obrigatório. Descrição da fatura, variando de 1 até 225 caracteres.

  • Posição: 3

  • Inglês: description

  • Tipo: Texto / String 

  • Exemplo: "Assinatura Cronapp"

Carga útil

Obrigatório. Carga útil da fatura definida pelo bot, 1-128 bytes, funciona como o id da fatura. Isso não será exibido ao usuário, use para seus processos internos.

  • Posição: 4

  • Inglês: payload

  • Tipo: Texto / String

  • Exemplo: "1234567890:TEST:AAAABBBBCCCCDDDD"

Token do provedor

Obrigatório. Token do provedor de pagamento, obtido via @BotFather.

  • Posição: 5

  • Inglês: provider token

  • Tipo: Texto / String 

  • Exemplo: "284685063:TEST:OTkxYTJkNjlkNzI2"

Parâmetro inicial

Opcional. Parâmetro exclusivo de deep_link. Se deixado em branco, as cópias encaminhadas da mensagem enviada terão um botão "Pagar", permitindo que vários usuários paguem diretamente pela mensagem encaminhada, usando a mesma fatura. Se não estiver vazia, as cópias encaminhadas da mensagem enviada terão um botão de URL com um link direto para o bot (em vez de um botão "Pagar") com o valor usado como parâmetro inicial.

  • Posição: 6

  • Inglês: start parameter

  • Tipo: Texto / String 

  • Exemplo: "https://t.me/share/url?url={encoded_url}"

Moeda

Obrigatório. É necessário fornecer um código de moeda ISO 4217 de três letras. Os valores mínimos e máximos aceitos para transações monetárias variam entre o equivalente a US$ 1 e US$ 10.000. O montante deve ser expresso em 12 dígitos ou menos, considerando que o valor máximo pode ser menor para algumas moedas de valor inferior. Para todas as moedas, exceto o dólar americano (USD), esses limites estão sujeitos a mudanças devido às taxas de câmbio, sendo importante antecipar essas variações ao implementar limites em seu código. Consulte mais informações sobre moedas.

  • Posição: 7

  • Inglês: currency

  • Tipo: Texto / String 

  • Exemplo: "BRL"

Preços

Obrigatório. Detalhamento de preços. Deve ser passada uma lista de componentes serializada em JSON (por exemplo, preço do produto, imposto, desconto, custo de entrega, imposto de entrega, bônus, etc.)

  • Posição: 8

  • Inglês: prices

  • Tipo: Array of LabeledPrice / Matriz de LabeledPrice

  • Exemplo: "[{'label': 'flores', 'amount': 1000}]"

Exemplo

No exemplo da figura abaixo, estamos enviando uma fatura para um usuário específico, identificado através dos parâmetros passados no bloco. 

Figura 2 - Função que envia uma fatura para um usuário

 

Nesta página