Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Use este bloco para enviar uma fatura para um usuário. Para mais detalhes, acesse a documentação oficial.
Informações |
---|
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 para orientação adicional.. Veja mais 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
Índice |
---|