Pagamento de ticket

Registra o pagamento de um ticket, com ou sem cartão de crédito, libera o ticket para saída e gera Recibo Provisório de Serviço (RPS). Em casos onde o integrador possui acordo com a garagem que permita a liberação de tickets 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, os parâmetros autorizacao, transacao, retorno_codigo, retorno_mensagem e cartao_credito_token são suprimidos. 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 do ticket para o integrador, 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. Observe que a GenPag, por padrão, ativa o anti-fraude. Assim, os parâmetros de consumidor são obrigatórios para a GenPag. Caso o parâmetro rps não seja informado, o RPS é gerado sem identificação do tomador do serviço. Caso o parâmetro rps seja informado, os parâmetros para identificação do tomador são obrigatórios. O parâmetro transacao 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/integradores/permanencia_pagamentos

HEADERS

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

Tipo: pix

Observação: Caso queira, o token pode ser enviado como hash na url do campo webhook, nesse caso, não enviaremos o token pele HEADER.

Tipo: credito

RETORNO EM CASO DE SUCESSO (200 – OK)

RETORNO EM CASO DE SUCESSO DE PAGAMENTO POR TICKET POR CARTÃO 

{
    "permanencia_pagamento": {
        "id": "69d5b2f7",
        "ticket": "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",
        "autorizacao": "12345678",
        "transacao": "1234567890",
        "retorno_codigo": "4",
        "retorno_mensagem": "Operation Successful",
        "cartao_credito_token": "db62dc71-d07b-4745-9969-42697b988ccb",
        "rps_numero": "000000123456",
        "nfce_qrcode": "http://dec.fazenda.uf.gov.br/ConsultarNFCe.aspx?p=5019131613336820762580901",
        "nfce_chave_acesso": "38010022300500997503763196132135776124080302",
        "tag": "ABCDEF0123456789",
        "tipo": "CREDITO"
    }
}

RETORNO EM CASO DE SUCESSO DE GERAR O QRCODE PARA PAGAMENTO POR PIX 

{
    "permanencia_pagamento": {
        "id": "69d5b2f7",
        "ticket": "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",
        "autorizacao": "12345678",
        "transacao": "1234567890",
        "retorno_codigo": "4",
        "retorno_mensagem": "Operation Successful",
        "cartao_credito_token": "",
        "rps_numero": "",
        "nfce_qrcode": "",
        "nfce_chave_acesso": "",
        "qrcode_pix": "00020101021226880014br.gov.bcb.pix2566qrcodes-h.cielo.com.br/pix-qr/d05b1a34-ec52-4201-ba1e-d3cc2a43162552040000530398654041.005802BR5918Merchant Teste HML6009Sao Paulo62120508000101296304031C",
        "tag": "ABCDEF0123456789",
        "tipo": "PIX"
    }
}

RETORNO EM CASO DE SUCESSO DE PAGAMENTO POR TICKET POR PIX,

FAREMOS UM POST PARA O URL CADASTRA NO WEBHOOK.

POST {url informada no webhook}

RETORNO DE SUCESSO DO PIX

{
    "permanencia_pagamento": {
        "id": "69d5b2f7",
        "ticket": "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",
        "autorizacao": "12345678",
        "transacao": "1234567890",
        "retorno_codigo": "4",
        "retorno_mensagem": "Operation Successful",
        "cartao_credito_token": "",
        "rps_numero": "000000123456",
        "nfce_qrcode": "http://dec.fazenda.uf.gov.br/ConsultarNFCe.aspx?p=5019131613336820762580901",
        "nfce_chave_acesso": "38010022300500997503763196132135776124080302",
        "tag": "ABCDEF0123456789",
        "tipo": "PIX",
        "status": "1"
    }
}

RETORNO DE CANCELAMENTO DO PIX

{
    "permanencia_pagamento": {
        "id": "69d5b2f7",
        "ticket": "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": "",
        "autorizacao": "12345678",
        "transacao": "1234567890",
        "retorno_codigo": "3",
        "retorno_mensagem": "Cancelado",
        "cartao_credito_token": "",
        "rps_numero": "",
        "nfce_qrcode": "",
        "nfce_chave_acesso": "",
        "tag": "ABCDEF0123456789",
        "tipo": "PIX",
        "status": "3"
    }
}

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."
}