Introdução
Nesta seção apresentamos o roteiro de vendas para o produto Guaicurus Digital. Para obter as informações do produto que serão utilizadas realize a operação Consultar Produtos disponível no anexo de Consultas
Validação do cartão Guaicurus
Para realizar qualquer venda do produto Guaicurus Digital deve se primeiro realizar a operação Validar Cartão para realizar a validação do cartão guaicurus que será utlizado na solicitação de venda no campo "nrCartao".
Exemplo de REQUEST:
GET /venda/transporte/guaicurus/valida-cartao/estabelecimento/123456 HTTP/1.1
Accept: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczpcL1wvc2FuZGJveC5ncnVwb2NhcmQuY29tLmJyIiwic3ViIjoiNzk3OGI0MzItYzdhYS01MzJhLTgyMjAtMDIxNzlkZWUyZmMwIiwiaWF0IjoxNjUzNDAwOTE3LCJleHAiOjE2NTM1NzM3MTcsIm5hbWUiOiJhZG1pbiJ9.Esyr2zga2LNGYAS0S79OXVqCDQ_ME6G5dzgDb6SNAro
Host: sandbox.grupocard.com.br
Exemplo de RESPONSE:
{
"result": "OK"
}
Fluxo de sucesso
1 - Consumir a operação Solicitar Venda
Utilize essa operação para solicitar a venda de qualquer produto disponível no estabelecimento. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se na resposta desta operação o campo status for igual a AUTORIZADA, na sequência a confirmação da transação deve ser enviada através da operação a seguir: Confirmar Venda
Obs. 1: Se ao invocar essa operação o cliente não obter uma resposta, é ALTAMENTE RECOMENDADO que seja realizado o cancelamento da solicitação.
Obs. 2: A representação dos centavos no campo "valor" não deve ter separação por virgula. Ex: R$10,99 = 1099
Obs.3: O campo "idExterno" é o identificador da requisição, sendo assim, deve ser enviado com um valor DIFERENTE a cada requisição.
Exemplo de REQUEST:
POST /venda/transporte/guaicurus/solicitar HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczpcL1wvc2FuZGJveC5ncnVwb2NhcmQuY29tLmJyIiwic3ViIjoiNmQwZjQyYzQtMWNjOS01ODNmLWE3N2QtZDI0ZmI0NGFjYTdhIiwiaWF0IjoxNjU2MzQxNTM2LCJleHAiOjE2NTY1MTQzMzYsIm5hbWUiOiJBZG1pbmlzdHJhdG9yIn0.-dnblIvspnmVnS-IQGjZkU3gZcKOr_vX4z1dG_a92hA
Host: sandbox.grupocard.com.br
Content-Length: 153
{"nrCartao":"123456","idExterno":"1019","estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4","dataHoraCliente":"2022-06-27T13:09:40.244Z","valor":"1000"}
{
"nrCartao":"123456",
"idExterno":"1019",
"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
"dataHoraCliente":"2022-06-27T13:09:40.244Z",
"valor":"1000"
}
Exemplo de RESPONSE:
{
"venda": {
"estabelecimento": {
"cnpjCpf": "75.862.116/0001-39",
"nome": "Homologação Plataforma WS recarga Multiproduto - NÃO MEXER"
},
"produto": {
"fornecedor": {
"nome": "CONSORCIO GUAICURUS"
}
},
"transacao": {
"valor": 1000,
"status": "AUTORIZADA",
"instrucao": "{\"recargaGuaicurus\":{\"nsuTendencia\":\"6a3dbbcd-2654-43b4-bc19-243efc04e7df\",\"nsuFornecedor\":\"243EFC04E7DF\",\"dataFornecedor\":\"27/06/2022 12:20:46\",\"mensagem\":\"Consorcio Guaicurus\"}}",
"complemento": "{\"nrCartao\":\"123456\"}",
"idTransacao": "6a3dbbcd-2654-43b4-bc19-243efc04e7df",
"dataHora": "2022-06-27T12:20:46.000-04:00"
},
"idExterno": "1019"
}
}
2 - Consumir a operação Confirmar Venda
Utilize essa operação para efetivar/confirmar uma transação de venda solicitada anteriormente pela operação Solicitar Venda
Obs. 1: A transação uma vez sendo Confirmada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
Exemplo de REQUEST:
POST /venda/transporte/guaicurus/confirmar HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczpcL1wvc2FuZGJveC5ncnVwb2NhcmQuY29tLmJyIiwic3ViIjoiNmQwZjQyYzQtMWNjOS01ODNmLWE3N2QtZDI0ZmI0NGFjYTdhIiwiaWF0IjoxNjU2MzQxNTM2LCJleHAiOjE2NTY1MTQzMzYsIm5hbWUiOiJBZG1pbmlzdHJhdG9yIn0.-dnblIvspnmVnS-IQGjZkU3gZcKOr_vX4z1dG_a92hA
Host: sandbox.grupocard.com.br
Content-Length: 182
{"idTransacao":"6a3dbbcd-2654-43b4-bc19-243efc04e7df","estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4","produto":"GUAICURUS DIGITAL","dataHoraCliente":"2022-06-27T13:09:40.244Z"}
{
"idTransacao":"6a3dbbcd-2654-43b4-bc19-243efc04e7df",
"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
"produto":"GUAICURUS DIGITAL",
"dataHoraCliente":"2022-06-27T13:09:40.244Z"
}
Exemplo de RESPONSE:
{
"transacao": {
"status": "EFETIVADA",
"idTransacao": "6a3dbbcd-2654-43b4-bc19-243efc04e7df"
}
}
Fluxo de cancelamento
1 - Consumir a operação Solicitar Venda
Utilize essa operação para solicitar a venda de qualquer produto disponível no estabelecimento. Este serviço faz apenas a SOLICITAÇÃO da venda, portanto, se optar por cancelar a venda, o cancelamento da transação deve ser enviada através da operação a seguir: Cancelar Venda
Obs. 1: Se ao invocar essa operação o cliente não obter uma resposta, é ALTAMENTE RECOMENDADO que seja realizado o cancelamento da solicitação.
Obs. 2: A representação dos centavos no campo "valor" não deve ter separação por virgula. Ex: R$10,99 = 1099
Obs.3: O campo "idExterno" é o identificador da requisição, sendo assim, deve ser enviado com um valor DIFERENTE a cada requisição.
Exemplo de REQUEST:
POST /venda/transporte/guaicurus/solicitar HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczpcL1wvc2FuZGJveC5ncnVwb2NhcmQuY29tLmJyIiwic3ViIjoiNmQwZjQyYzQtMWNjOS01ODNmLWE3N2QtZDI0ZmI0NGFjYTdhIiwiaWF0IjoxNjU2MzQxNTM2LCJleHAiOjE2NTY1MTQzMzYsIm5hbWUiOiJBZG1pbmlzdHJhdG9yIn0.-dnblIvspnmVnS-IQGjZkU3gZcKOr_vX4z1dG_a92hA
Host: sandbox.grupocard.com.br
Content-Length: 153
{"nrCartao":"111456","idExterno":"1021","estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4","dataHoraCliente":"2022-06-27T13:09:40.244Z","valor":"6000"}
{
"nrCartao":"111456",
"idExterno":"1021",
"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
"dataHoraCliente":"2022-06-27T13:09:40.244Z",
"valor":"6000"
}
Exemplo de RESPONSE:
{
"venda": {
"estabelecimento": {
"cnpjCpf": "75.862.116/0001-39",
"nome": "Homologação Plataforma WS recarga Multiproduto - NÃO MEXER"
},
"produto": {
"fornecedor": {
"nome": "CONSORCIO GUAICURUS"
}
},
"transacao": {
"valor": 6000,
"status": "AUTORIZADA",
"instrucao": "{\"recargaGuaicurus\":{\"nsuTendencia\":\"2ea3a08c-4ba6-48c1-bb27-e15b2b8feb46\",\"nsuFornecedor\":\"E15B2B8FEB46\",\"dataFornecedor\":\"27/06/2022 12:27:08\",\"mensagem\":\"Consorcio Guaicurus\"}}",
"complemento": "{\"nrCartao\":\"111456\"}",
"idTransacao": "2ea3a08c-4ba6-48c1-bb27-e15b2b8feb46",
"dataHora": "2022-06-27T12:27:08.000-04:00"
},
"idExterno": "1021"
}
}
2 - Consumir a operação Cancelar Venda
Utilize essa operação para cancelar uma transação de venda solicitada anteriormente pela operação Solicitar Venda
Obs. 1: A transação uma vez sendo Cancelada, seu status não poderá mais ser alterado, e mesmo que a operação seja invocada para tal ação, não surtirá efeito!
Exemplo de REQUEST:
POST /venda/transporte/sptrans/cancelar HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczpcL1wvc2FuZGJveC5ncnVwb2NhcmQuY29tLmJyIiwic3ViIjoiNmQwZjQyYzQtMWNjOS01ODNmLWE3N2QtZDI0ZmI0NGFjYTdhIiwiaWF0IjoxNjU2MzQxNTM2LCJleHAiOjE2NTY1MTQzMzYsIm5hbWUiOiJBZG1pbmlzdHJhdG9yIn0.-dnblIvspnmVnS-IQGjZkU3gZcKOr_vX4z1dG_a92hA
Host: sandbox.grupocard.com.br
Content-Length: 118
{"idExterno":"1021","estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4","dataHoraCliente":"2022-06-27T13:09:40.244Z"}
{
"idExterno":"1021",
"estabelecimento":"81AA1C20B1688E4C7424C4E000334DD4",
"dataHoraCliente":"2022-06-27T13:09:40.244Z"
}
Exemplo de RESPONSE:
{
"transacao": {
"status": "CANCELADA"
}
}