Criação de Transações

Para ser criada uma transação é necessário que seja feita uma requisição POST no endpoint SetVendaTef, com os seguintes headers:

HeaderDescrição
CNPJCnpj (somente números) do cliente
PDVNúmero do PDV com 3 caracteres. Ex: “001”
TOKENString necessária para as requisições, fornecida pela Multiplus Card
CONTEUDOConteúdo da requisição, nas seções seguintes será descrito os campos necessários
CALLBACK(Opcional) URL que devemos notificar

Callback

Caso inclua o header CALLBACK no SetVendaTef, seu valor deverá conter a URL que será utilizada na notificação, desta forma cada requisição pode ter um endereço de callback diferente da outra.

O conteúdo do body será o mesmo que receberia ao fazer uma requisição no endpoint GetVendasTef, após o ClientTEF realizar a execução.

Exemplo de Callback
https://api.meusistema.com.br/tef/SetVendaTefCallback
Exemplo de Retorno
000-000 = CRT¬001-000 = 3¬003-000 = 002¬009-000 = 255¬028-000 = 0¬
030-000 = Cancelado pelo operador.¬800-000 = v1.416.71¬999-999 = 0

Em automações desenvolvidas com linguagens/frameworks que sigam a RFC 7230, que não permite caracteres não-ASCII nos headers (ex.: .NET Core), o caractere ‘¬’ deve ser enviado com codificação HTML da seguinte forma: ‘¬

Retornos da Transação

Ao realizar a requisição o endpoint SetVendaTef em caso de sucesso (HTTP status 200), poderá ter algum dos seguintes retornos:

RetornoDescrição
“0000”Hash da transação, é um número inteiro utilizado para as consultas referentes à mesma.
[ERRO]: Erro ao incluir a vendaErro na inclusão da venda
[ERRO]: Verificar ParâmetrosOcorre na ausência de parâmetros necessários para a consulta.
[ERRO]: “descrição do erro”Erro não previsto, retorno com a descrição do mesmo.

© 2025 Multiplus Card. Todos os direitos reservados.