Faturamento de estadia

Registra o faturamento de uma estadia, com ou sem cartão de crédito, libera a estadia para saída e gera documento fiscal. Em casos onde o integrador possui acordo com a garagem que permita a liberação de estadias sem pagamento, o parâmetro cartao_credito não é obrigatório, o processamento do pagamento não direciona a transação para os adquirentes e no retorno, o parâmetro cartao_credito_token será suprimido. Atualmente, a API permite o pagamento através dos adquirentes Cielo, Getnet, Maxipago e Stone (via e-SiTef). Embora a API encapsule as particularidades de cada adquirente, de forma a criar uma linguagem padronizada para pagamento da estadia, independente do adquirente em uso, essas particularidades precisam ser respeitadas pelo desenvolvedor do aplicativo de pagamento. Em ambiente de desenvolvimento, a Cielo, a Maxipago e e-SiTef permitem o reaproveitamento do token do cartão de crédito para pagamento de mais de uma estadia, enquanto a Getnet não permite o reaproveitamento do token do cartão de crédito para pagamento de mais de uma estadia e exige que um novo token seja gerado a cada transação. Para pagamento através do token do cartão de crédito, a Cielo, a Maxipago e e-SiTef esperam somente o parâmetro cartao_credito.token, enquanto a Getnet espera os parâmetros cartao_credito.token, cartao_credito.portador e cartao_credito.validade, mesmo que esses parâmetros tenham sido enviados para a Getnet no momento da tokenização do cartão. Caso o parâmetro documento_fiscal não seja informado, o documento fiscal é gerado sem identificação do tomador do serviço. Caso o parâmetro documento_fiscal seja informado, os parâmetros para identificação do tomador são obrigatórios. O parâmetro transacao_id identifica a consulta feita previamente. A transação possui tempo de validade, entre a consulta e a confirmação do pagamento, dependente de configuração em cada garagem. Após o tempo de validade, a transação não é mais válida e não poder ser mais utilizada. Neste caso, deve ser requisitada uma nova consulta de ticket e gerada nova transação. Em ambiente de desenvolvimento o retorno da transação com cartão de crédito depende do adquirente e do número do cartão de crédito utilizado, conforme a lista a seguir.

Quando o adquirente for a Cielo:

Quando o adquirente for a Getnet:

Quando for e-SiTef:

Quando o adquirente for a Maxipago:

O pagamento de um ticket por cartão de crédito é realizado em três etapas: a primeira etapa cria uma transação na adquirente; a segunda registra o pagamento na garagem; e a terceira captura a transação na adquirente. Esse processo garante que a transação somente seja cobrada do cliente se ela for registrada na garagem. Caso a primeira ou segunda etapa não seja concluída com sucesso, a transação é cancelada na adquirente.

POST api/estadias_faturamentos

HEADERS

PARÂMETROS (BODY)
Todos os valores devem ser enviados como strings.

RETORNO EM CASO DE SUCESSO (200 – OK)

RETORNO EM CASO DE SUCESSO DE PAGAMENTO 

{
    "estadia_faturamento": {
        "id": "73b4cab7-ea27-426c-b247-bf0f006e0f05",
        "localizador": "1234567890",
        "entrada_datahora": "2019-08-30T18:35:25.000-03:00",
        "registro_datahora": "2019-08-30T20:49:20.000-03:00",
        "validade_datahora": "2019-08-30T21:35:25.000-03:00",
        "valor_pago": "5.0",
        "documento_fiscal_numero": "000000123456",
        "tag": "ABCDEF0123456789",
        "modalidade_pagamento_id": "73b4cab7-ea27-426c-b247-bf0f006e0f05",
        "modalidade_pagamento_nome": "CARTÃO"
    }
}

OUTROS RETORNOS

EXEMPLO DE RETORNO EM CASO DE ERRO (422 – UNPROCESSABLE ENTITY)

{
	"error": {
      	"retorno_codigo": "05",
		"retorno_mensagem": "Operação não autorizada"
	}
}

EXEMPLO DE RETORNO EM CASO DE ERRO (502 – BAD GATEWAY)

{
	"error": "Serviço indisponível no momento. Realize o pagamento nos caixas do estacionamento."
}