Pagamento de ticket

Registra o pagamento de um ticket, com ou sem cartãcartão de crécrédito, libera o ticket para saísaída e gera Recibo ProvisóProvisório de ServiçServiço (RPS). Em casos onde o integrador possui acordo com a garagem que permita a liberaçãliberação de tickets sem pagamento, o parâparâmetro cartao_credito nãnão éé obrigatóobrigatório, o processamento do pagamento nãnão direciona a transaçãtransação para os adquirentes e no retorno, os parâparâmetros autorizacao, transacao, retorno_codigo, retorno_mensagem e cartao_credito_token sãsão suprimidos. Atualmente, a API permite o pagamento atravé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ãcartão de crécrédito para pagamento de mais de uma estadia, enquanto a Getnet nãnão permite o reaproveitamento do token do cartãcartão de crécrédito para pagamento de mais de uma estadia e exige que um novo token seja gerado a cada transaçãtransação. Para pagamento atravéatravés do token do cartãcartão de crécrédito, a Cielo, a Maxipago e e-SiTef esperam somente o parâparâmetro cartao_credito.token, enquanto a Getnet espera os parâparâmetros cartao_credito.token, cartao_credito.portador e cartao_credito.validade, mesmo que esses parâparâmetros tenham sido enviados para a Getnet no momento da tokenizaçãtokenização do cartãcartão. Observe que a GenPag, por padrãpadrão, ativa o anti-fraude. Assim, os parâparâmetros de consumidor sãsão obrigatóobrigatórios para a GenPag. Caso o parâparâmetro rps nãnão seja informado, o RPS éé gerado sem identificaçãidentificação do tomador do serviçserviço. Caso o parâparâmetro rps seja informado, os parâparâmetros para identificaçãidentificação do tomador sãsão obrigatóobrigatórios. O parâparâmetro transacao identifica a consulta feita previamente. A transaçãtransação possui tempo de validade, entre a consulta e a confirmaçãconfirmação do pagamento, dependente de configuraçãconfiguração em cada garagem. ApóApós o tempo de validade, a transaçãtransação nãnão éé mais váválida e nãnão poder ser mais utilizada. Neste caso, deve ser requisitada uma nova consulta de ticket e gerada nova transaçãtransação. Em ambiente de desenvolvimento o retorno da transaçãtransação com cartãcartão de crécrédito depende do adquirente e do núnúmero do cartãcartão de cré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ãcartão de crécrédito éé realizado em trêtrês etapas: a primeira etapa cria uma transaçãtransação na adquirente; a segunda registra o pagamento na garagem; e a terceira captura a transaçãtransação na adquirente. Esse processo garante que a transaçãtransação somente seja cobrada do cliente se ela for registrada na garagem. Caso a primeira ou segunda etapa nãnão seja concluíconcluída com sucesso, a transaçãtransação éé cancelada na adquirente.

POST api/integradores/permanencia_pagamentos

HEADERS

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

Tipo: pix

ObservaçãObservação: Caso queira, o token pode ser enviado como hash na url do campo webhook, nesse caso, nã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Ã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"
    }
}

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

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}

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

OUTROS RETORNOS

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

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

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

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