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

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