Descrição

O endpoint New Sale é utilizado para registrar a venda de serviços e contratos, ou até aulas experimentais, para prospects e membros. Após a solicitação, o sistema registra a transação, criando ou associando um prospect a um cliente (membro), e registra o pagamento, que pode ser à vista ou parcelado. O processo inclui a aplicação de descontos, a escolha da filial e o gerenciamento de informações de pagamento.

Artigos complementares:

Como realizar uma venda online via API

Atenção!

O totalInstallments do objeto CardDate é valido apenas para o pagamento do tipo 1 (Cartão de crédito)

Parâmetros do Payload

Parâmetro	Tipo	Obrigatório	Descrição
`idBranch`	int32	Não	Identificador da filial onde a venda foi realizada. Se o sistema for multifilial, preencha com o ID da unidade específica. Caso contrário, será o valor gerado pelo token.
`idBranchToken`	string	Não	Token da filial, utilizado para identificar a unidade quando o sistema é multifilial.
`idMembership`	int32	Não	Identificador do contrato de adesão adquirido (se aplicável).
`idService`	int32	Não	Identificador do serviço ou aula experimental adquirida.
`serviceValue`	double	Não	Valor final do serviço, podendo ser ajustado para descontos ou alterações.
`memberData`	object	Sim	Dados do membro (se o cliente já for um membro). Contém o campo `idMember`.
`cardData`	object	Não	Dados do cartão de crédito, se a transação for realizada via cartão.
`idProspect`	int32	Não	Identificador do prospecto que está adquirindo o serviço.
`idProspectToken`	string	Não	Token do prospecto, utilizado para validar a transação e garantir que o prospecto seja convertido em membro após a compra.
`idMemberToken`	string	Não	Token do membro (se for um cliente registrado).
`voucher`	string	Não	Código do voucher de desconto, caso o cliente utilize um para obter um desconto.
`idCardMember`	int32	Não	Identificador do cartão de membro (se aplicável).
`idMemberCardToken`	string	Não	Token do cartão de membro (se aplicável).
`totalInstallments`	int32	Sim	Número de parcelas para pagamento parcelado. Para pagamento à vista, será 0 ou 1.
`payment`	int32	Sim	Tipo de pagamento: 5 para parcelamento (com valor zerado para aulas experimentais) e 6 para pagamento à vista.
`sessionId`	string	Não	Identificador da sessão, utilizado para rastrear a transação durante o processo de venda.

Parametros do objeto: MemberData

Parâmetro	Tipo	Obrigatório	Descrição
`idMember`	int32	Sim	Identificador único do membro.
`document`	string	Não	Documento de identificação do membro, como CPF ou CNPJ.
`zipCode`	string	Não	Código postal (CEP) do endereço do membro.
`address`	string	Não	Endereço do membro.
`number`	string	Não	Número do endereço do membro.
`complement`	string	Não	Complemento do endereço do membro, como apartamento ou bloco.
`neighborhood`	string	Não	Bairro do membro.
`city`	string	Não	Cidade do membro.
`idState`	int32	Não	Identificador do estado onde o membro reside.

Parametros do objeto: CardData

Parâmetro	Tipo	Obrigatório	Descrição
`token`	string	Não	Identificador único para o cartão.
`temporaryToken`	string	Não	Token temporário associado ao cartão, se aplicável.
`branchToken`	string	Não	Token da filial para identificar uma unidade quando o sistema é multifilial.
`totalInstallments`	int32	Não	Número total de parcelas no pagamento, aplicável em transações parceladas.
`truncatedCardNumber`	string	Não	Número do cartão truncado, mostrando apenas os ultimos 4 números reais para segurança. (****1234)
`brand`	string	Não	Marca do cartão (exemplo: Visa, MasterCard, etc.).
`cardHolderName`	string	Não	Nome do titular do cartão.
`cardExpirationYear`	int32	Não	Ano de expiração do cartão.
`cardExpirationMonth`	int32	Não	Mês de expiração do cartão.

Tipos de Payment

Código	Tipo de Pagamento	Descrição
null	LinkCheckout	Caso o valor de `payment` seja nulo, é tratado como LinkCheckout.
1	Credit Card	Pagamento realizado com cartão de crédito. (É preciso gerar o token do cartão usando Evo Pay
2	Boleto	Pagamento realizado via boleto bancário.
3	Sale Credits	Pagamento realizado com créditos de vendas.
4	Transfer	Pagamento realizado por transferência bancária.
5	ValorZerado	Utilizado para transações com valor zerado, como aulas experimentais.
6	LinkCheckout	Pagamento realizado via link de checkout (gerado externamente).
7	Pix	Pagamento realizado via Pix.
13	Transferência	Pagamento realizado via transferência bancaria