Variáveis e placeholders

Ao montar a solicitação ao PSP —body, cabeçalhos e verificação de status— você pode usar placeholders {{...}}. O Jelou os substitui em tempo de execução pelos dados reais da cobrança.

Placeholders disponíveis

Placeholder	Descrição
`{{credencial_key}}`	Qualquer `key` que você tenha declarado na etapa Credenciais do assistente.
`{{amount}}`	Valor total simples da cobrança.
`{{currency}}`	Moeda da cobrança (por exemplo `USD`).
`{{description}}`	Descrição da cobrança.
`{{order.id}}`	Identificador interno do pedido gerado pelo Jelou.
`{{order.reference_id}}`	Identificador de referência externo do pedido.
`{{order.metadata}}`	Objeto com metadados adicionais do pedido. É inserido sem aspas no JSON, como objeto.
`{{order.non_taxable_amount}}`	Valor não tributável (detalhamento de impostos).
`{{order.taxable_amount}}`	Valor tributável (detalhamento de impostos).
`{{order.tax}}`	Valor do imposto aplicado.
`{{order.tax_percentage}}`	Percentual de imposto, derivado (`tax / taxable_amount * 100`).
`{{customer.reference_id}}`	Identificador interno do cliente.
`{{customer.phone}}`	Telefone do cliente.
`{{customer.email}}`	E-mail do cliente.
`{{customer.full_name}}` / `{{customer.middle_name}}` / `{{customer.surname}}`	Nome do cliente.
`{{customer.legal_id_type}}` / `{{customer.legal_id}}`	Documento de identidade (CPF, RUC, etc.).
`{{customer.address}}`	Endereço do cliente.
`{{customer.country}}`	País do cliente.
`{{returnUrl}}`	URL de retorno após o checkout. Resolve para o callback próprio do Jelou se você configurou Verificar status com o PSP no retorno; caso contrário, resolve para a URL de retorno enviada pelo consumidor da API.
`{{webhookUrl}}`	URL própria do webhook do gateway — útil se seu PSP aceita configurar o callback dentro do mesmo payload de criação da cobrança.
`{{expiration.duration_seconds}}` / `{{expiration.duration_minutes}}` / `{{expiration.expires_at_unix}}` / `{{expiration.expires_at_unix_ms}}` / `{{expiration.expires_at_iso8601}}`	Vigência do checkout.

A vigência do checkout é fixa em uma janela de 30 horas a partir da criação — ainda não é configurável por gateway nem por solicitação.

Dentro de Verificar status com o PSP no retorno (e somente ali) também existe {{transaction_id}}. Use-o na URL, nos cabeçalhos ou no body dessa consulta; sem ele, a verificação não distinguiria entre transações.

Exemplo de `body_template`

body_template de exemplo

{
  "amount": {{amount}},
  "currency": "{{currency}}",
  "description": "{{description}}",
  "reference": "{{order.reference_id}}",
  "customer": {
    "name": "{{customer.full_name}}",
    "email": "{{customer.email}}",
    "phone": "{{customer.phone}}"
  },
  "api_key": "{{apiKey}}",
  "callback_url": "{{webhookUrl}}"
}

Neste exemplo, {{apiKey}} é uma credencial declarada na etapa Credenciais do assistente; o restante são placeholders do sistema listados acima.

Seções condicionais

O body template também oferece inclusão condicional simples (sem aninhamento nem loops), útil para omitir campos sem valor:

{{#campo}}...{{/campo}} — inclui o conteúdo se campo tiver um valor verdadeiro.
{{^campo}}...{{/campo}} — inclui o conteúdo se campo for falso ou estiver vazio.

Regras de validação

Qualquer {{...}} que não esteja nesta página, não seja uma credencial declarada, ou (somente na verificação de status) {{transaction_id}}, é considerado um placeholder desconhecido.
Um placeholder desconhecido bloqueia o salvamento no assistente e também no backend.

Se o seu body usa {{returnUrl}} e você não ativou a verificação de status no retorno, cada solicitação de cobrança deve incluir a URL de retorno explicitamente, ou o Jelou a rejeita.

Próximos passos

Criar um gateway personalizado

Volte ao assistente de 6 etapas para aplicar estes placeholders.

Testar o gateway

Verifique como seus placeholders são renderizados antes de publicar em produção.

Primeiros Passos

Desenvolvedor

Jelou CLI

Mensagens Outbound

Gestão

Marketplace

Canais

Configuração

Faturamento

Variáveis e placeholders

Placeholders disponíveis

Exemplo de `body_template`

Seções condicionais

Regras de validação

Próximos passos

Criar um gateway personalizado

Testar o gateway

​Placeholders disponíveis

​Exemplo de body_template

​Seções condicionais

​Regras de validação

​Próximos passos

Criar um gateway personalizado

Testar o gateway

Placeholders disponíveis

Exemplo de `body_template`

Seções condicionais

Regras de validação

Próximos passos