Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 7 Próxima »

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. 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. Código de moeda ISO 4217 de três letras. Os valores mínimo e máximo para cada uma das moedas correspondem aproximadamente ao limite de US$ 1-10000. O montante deve ser expresso em 12 dígitos ou menos, pelo que o valor máximo será correspondentemente inferior para algumas moedas de valor inferior. Para cada moeda, exceto USD, esses limites dependem das taxas de câmbio e podem mudar com o tempo (planeje isso com antecedência ao implementar limites em seu código). Veja mais sobre moedas.

  • Posição: 7
  • Inglês: Video note
  • 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


  • Sem rótulos