Pagamento de ticket

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

POST api/integradores/permanencia_pagamentos

HEADERS

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

Tipo: pix

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

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

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