Use este bloco para enviar uma fatura para um usuário. Para mais detalhes, acesse a documentação oficial.
![](/download/attachments/284886245/EnviarFaturaBloco.png?version=1&modificationDate=1714161464000&api=v2)
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.
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.
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.
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.
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.)
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.
![](/download/attachments/284886245/EnviarFaturaFuncao.png?version=3&modificationDate=1714499110000&api=v2)
Figura 2 - Função que envia uma fatura para um usuário