Introdução
Nesta seção apresentamos o roteiro de vendas para os produtos de Recarga E-Gift, que são produtos digitais que retornam uma url de ativação em sua confirmação de venda. Para obter as informações de quais produtos possuem a característica EGIFT e suas respectivas informações padrão realize a operação Consultar Produtos disponível no anexo de Consultas, sendo identificados pelo campo "característica" do payload de resposta tal qual:
"caracteristica": "EGIFT"
Para obter as informações específicas dos produtos que serão necessárias para realizar a venda deve se consumir a operação Consultar informações complementares
Consulta de informações específicas dos produtos
Para realizar qualquer venda de produtos com características EGIFT deve se consumir a operação Consultar informações complementares para obter informações específicas de um produto EGIFT e os valores dos campos: "chaveProduto", "configuracaoId", tais valores desses campos deverão ser usados na solicitação de venda EGIFT disponível em Solicitar Venda .
"chaveProduto": "67BP5JDZRRAX4005K8YZ1K9YKC",
"configuracaoId": "2RQXHX8KZLD1HQBVYQ5ZMFTFBD",
"valorMinimo": 2000,
"valorMaximo": 2000
Exemplo de REQUEST:
GET /venda/egift/consulta-dinamica/81AA1C20B1688E4C7424C4E000334DD4/LEAGUEOFLEGENDS HTTP/1.1
Accept: application/json
Host: sandbox.grupocard.com.br
Exemplo de RESPONSE:
{
"dataHora": "23/05/2022 09:37:58",
"catalogo": "Tendencia",
"token": "81AA1C20B1688E4C7424C4E000334DD4",
"produtos": [
{
"id": 2151,
"nome": "RIOT (LEAGUE OF LEGENDS) 20 BRL",
"nomeMenu": "LEAGUEOFLEGENDS",
"chaveProduto": "67BP5JDZRRAX4005K8YZ1K9YKC",
"configuracaoId": "2RQXHX8KZLD1HQBVYQ5ZMFTFBD",
"imagens": [
{
"url": "https://content.blackhawknetwork.com/gcmimages/product/xlarge/80329.jpg",
"tamanho": "EXTRA_LARGE"
},
{
"url": "https://content.blackhawknetwork.com/gcmimages/product/xxlarge/80329.jpg",
"tamanho": "EXTRA_EXTRA_LARGE"
}
],
"valorMinimo": 2000,
"valorMaximo": 2000,
"valorInformado": false,
"termos": [
{
"texto": "Verifique os termos de uso atualizados de League of Legends em: http://br.leagueoflegends.com/pt/legal/termsofuse",
"tipo": "EMAIL"
},
{
"texto": "Verifique os termos de uso atualizados de League of Legends em: http://br.leagueoflegends.com/pt/legal/termsofuse",
"tipo": "WEB"
},
{
"texto": "Verifique os termos de uso atualizados de League of Legends em: http://br.leagueoflegends.com/pt/legal/termsofuse",
"tipo": "PHYSICAL"
}
],
"instrucoes": [
{
"texto": "Dentro do jogo, acesse a area de Cartoes e Codigos Pre-Pagos na Loja e use seu codigo, CPF e data de nascimento para resgatar os RP's.",
"tipo": "REDEMPTION_INFORMATION"
},
{
"texto": "Dentro do jogo, acesse a area de Cartoes e Codigos Pre-Pagos na Loja e use seu codigo, CPF e data de nascimento para resgatar os RP's.",
"tipo": "ON_LINE_INSTRUCTIONS"
}
]
},
{
"id": 2151,
"nome": "RIOT (LEAGUE OF LEGENDS) 50 BRL",
"nomeMenu": "LEAGUEOFLEGENDS",
"chaveProduto": "KGHGCGXY6HWBSGCTS83J2BHTCM",
"configuracaoId": "HR4CBCMDDGCLMZ24WR3PJS3FXQ",
"imagens": [
{
"url": "https://content.blackhawknetwork.com/gcmimages/product/xlarge/80327.jpg",
"tamanho": "EXTRA_LARGE"
},
{
"url": "https://content.blackhawknetwork.com/gcmimages/product/xxlarge/80327.jpg",
"tamanho": "EXTRA_EXTRA_LARGE"
}
],
"valorMinimo": 5000,
"valorMaximo": 5000,
"valorInformado": false,
"termos": [
{
"texto": "Verifique os termos de uso atualizados de League of Legends em: http://br.leagueoflegends.com/pt/legal/termsofuse",
"tipo": "EMAIL"
},
{
"texto": "Verifique os termos de uso atualizados de League of Legends em: http://br.leagueoflegends.com/pt/legal/termsofuse",
"tipo": "WEB"
},
{
"texto": "Verifique os termos de uso atualizados de League of Legends em: http://br.leagueoflegends.com/pt/legal/termsofuse",
"tipo": "PHYSICAL"
}
],
"instrucoes": [
{
"texto": "Dentro do jogo, acesse a area de Cartoes e Codigos Pre-Pagos na Loja e use seu codigo, CPF e data de nascimento para resgatar os RP's.",
"tipo": "REDEMPTION_INFORMATION"
},
{
"texto": "Dentro do jogo, acesse a area de Cartoes e Codigos Pre-Pagos na Loja e use seu codigo, CPF e data de nascimento para resgatar os RP's.",
"tipo": "ON_LINE_INSTRUCTIONS"
}
]
},
{
"id": 2151,
"nome": "Vale-presente 100BRL do Google Play",
"nomeMenu": "LEAGUEOFLEGENDS",
"chaveProduto": "46J477150K5WBCR9BYT569LX7B",
"configuracaoId": "A0DQTP3HLK4LHS0CZY95MTKFHL",
"imagens": [
{
"url": "https://content.blackhawknetwork.com/gcmimages/product/xxlarge/88207.png",
"tamanho": "EXTRA_EXTRA_LARGE"
},
{
"url": "https://content.blackhawknetwork.com/gcmimages/product/xlarge/88207.png",
"tamanho": "EXTRA_LARGE"
}
],
"valorMinimo": 10000,
"valorMaximo": 10000,
"valorInformado": false,
"termos": [
{
"texto": "veja a integra dos Termos e Condicoes e da politica de privacidade em play.google.com/br-card-terms. Vale-presente (Gift Card) emitido por Google Brasil Pagamentos Ltda. (Google Payments Brazil). Os usuarios devem ser residentes no Brasil e ter 13 anos de idade ou mais (usuarios com idade entre 13 e 17 anos necessitam de permissao dos pais ou responsavel). Requer uma conta brasileira no Google Payments e acesso a Internet para realizar o resgate. Valido apenas para itens qualificados no Google Play. Nao pode ser utilizado para comprar itens classificados como Hardware e determinadas assinaturas. Sujeito a outras limitacoes. Nao esta sujeito a incidencia de taxas ou vencimento. Exceto se exigido por lei, o vale-presente nao pode ser resgatado em dinheiro ou em outros vales-presente. Nao recarregavel ou passivel de reembolso; nao pode ser utilizado em conjunto com outros saldos nao provenientes do Google Play; nao pode ser revendido, trocado ou transferido por meio do recebimento de qualquer valor. O usuario e responsavel pela eventual perda do cartao. Para ajuda ou para ver o saldo acesse support.google.com/googleplay/go/cardhelp.",
"tipo": "PHYSICAL"
},
{
"texto": "veja a integra dos Termos e Condicoes e da politica de privacidade em play.google.com/br-card-terms. Vale-presente (Gift Card) emitido por Google Brasil Pagamentos Ltda. (Google Payments Brazil). Os usuarios devem ser residentes no Brasil e ter 13 anos de idade ou mais (usuarios com idade entre 13 e 17 anos necessitam de permissao dos pais ou responsavel). Requer uma conta brasileira no Google Payments e acesso a Internet para realizar o resgate. Valido apenas para itens qualificados no Google Play. Nao pode ser utilizado para comprar itens classificados como Hardware e determinadas assinaturas. Sujeito a outras limitacoes. Nao esta sujeito a incidencia de taxas ou vencimento. Exceto se exigido por lei, o vale-presente nao pode ser resgatado em dinheiro ou em outros vales-presente. Nao recarregavel ou passivel de reembolso; nao pode ser utilizado em conjunto com outros saldos nao provenientes do Google Play; nao pode ser revendido, trocado ou transferido por meio do recebimento de qualquer valor. O usuario e responsavel pela eventual perda do cartao. Para ajuda ou para ver o saldo acesse support.google.com/googleplay/go/cardhelp.",
"tipo": "WEB"
},
{
"texto": "veja a integra dos Termos e Condicoes e da politica de privacidade em play.google.com/br-card-terms. Vale-presente (Gift Card) emitido por Google Brasil Pagamentos Ltda. (Google Payments Brazil). Os usuarios devem ser residentes no Brasil e ter 13 anos de idade ou mais (usuarios com idade entre 13 e 17 anos necessitam de permissao dos pais ou responsavel). Requer uma conta brasileira no Google Payments e acesso a Internet para realizar o resgate. Valido apenas para itens qualificados no Google Play. Nao pode ser utilizado para comprar itens classificados como Hardware e determinadas assinaturas. Sujeito a outras limitacoes. Nao esta sujeito a incidencia de taxas ou vencimento. Exceto se exigido por lei, o vale-presente nao pode ser resgatado em dinheiro ou em outros vales-presente. Nao recarregavel ou passivel de reembolso; nao pode ser utilizado em conjunto com outros saldos nao provenientes do Google Play; nao pode ser revendido, trocado ou transferido por meio do recebimento de qualquer valor. O usuario e responsavel pela eventual perda do cartao. Para ajuda ou para ver o saldo acesse support.google.com/googleplay/go/cardhelp.",
"tipo": "EMAIL"
}
],
"instrucoes": [
{
"texto": "Para resgatar, insira o codigo no app Play Store ou em play.google.com. \nIMPORTANTE: so use o codigo deste vale-presente no Google Play. Outras solicitacoes deste codigo podem ser golpes. Acesse play.google.com/giftcardscam.",
"tipo": "ON_LINE_INSTRUCTIONS"
},
{
"texto": "https://play.google.com/store?code=%%ACCOUNTNUMBER%%",
"tipo": "REDEMPTION_INFORMATION"
}
]
}
]
}
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 "valor" deve ser preenchido com um valor correspondido entre os valores dos campos "valorMinino" e "valorMaximo" da resposta da operação anterior Consultar informações complementares.
Obs.4: 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/egift/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: 324
{"estabelecimento":"FC36876DD0B9F34F8A021DE7CE400803","idExterno":"1016","produto":"MINECRAFT MINECOINS","fornecedor":"XBOX MICROSOFT","tipoProduto":"ONLINE","tipoNegocio":7,"chaveProduto":"DWNLPS1Z7QFQBS9MJLJ700DQJB","configuracaoId":"WQ2L2M9ABVYZP3SD211LWVNS16","dataHoraCliente":"2022-06-27T13:09:40.244Z","valor":"3795"}
{
"estabelecimento":"FC36876DD0B9F34F8A021DE7CE400803",
"idExterno":"1016",
"produto":"MINECRAFT MINECOINS",
"fornecedor":"XBOX MICROSOFT",
"tipoProduto":"ONLINE",
"tipoNegocio":7,
"chaveProduto":"DWNLPS1Z7QFQBS9MJLJ700DQJB",
"configuracaoId":"WQ2L2M9ABVYZP3SD211LWVNS16",
"dataHoraCliente":"2022-06-27T13:09:40.244Z",
"valor":"3795"
}
Exemplo de RESPONSE:
{
"venda": {
"estabelecimento": {
"cnpjCpf": "95.617.473/0001-49",
"nome": "Homologação Plataforma EGIFT - NÃO MEXER"
},
"produto": {
"fornecedor": {
"nome": "XBOX MICROSOFT"
}
},
"transacao": {
"valor": 3795,
"status": "AUTORIZADA",
"idTransacao": "e158bb8f-28de-4003-801b-071b876cbb0f",
"dataHora": "2022-06-27T11:37:52.000-04:00"
},
"idExterno": "1016"
}
}
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/egift/confirmar HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: sandbox.grupocard.com.br
Content-Length: 184
{"idTransacao":"e158bb8f-28de-4003-801b-071b876cbb0f","estabelecimento":"FC36876DD0B9F34F8A021DE7CE400803","produto":"MINECRAFT MINECOINS","dataHoraCliente":"2022-06-27T13:09:40.244Z"}
{
"idTransacao":"e158bb8f-28de-4003-801b-071b876cbb0f",
"estabelecimento":"FC36876DD0B9F34F8A021DE7CE400803",
"produto":"MINECRAFT MINECOINS",
"dataHoraCliente":"2022-06-27T13:09:40.244Z"
}
Exemplo de RESPONSE:
{
"transacao": {
"status": "EFETIVADA",
"instrucao": "{\"estabelecimento\":\"Homologacao Plataforma EGIFT - NAO MEXER\",\"produto\":\"MINECRAFT MINECOINS\",\"valor\":3795,\"token\":\"FC36876DD0B9F34F8A021DE7CE400803\",\"estabelecimentoId\":1211489,\"urlAtivacao\":\"https://egift.certification.blackhawknetwork.com/egift?eid=7AA91C6EC12F97DA428541D718D09F05&tid=GHTVHQSTALWBJL9NAFPQSLGVMS\",\"dataTransacao\":\"27/06/2022 11:37:52\",\"transacaoId\":\"e158bb8f-28de-4003-801b-071b876cbb0f\"}",
"idTransacao": "e158bb8f-28de-4003-801b-071b876cbb0f"
}
}
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 "valor" deve ser preenchido com um valor correspondido entre os valores dos campos "valorMinino" e "valorMaximo" da resposta da operação anterior Consultar informações complementares.
Obs.4: 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/egift/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: 306
{"estabelecimento":"FC36876DD0B9F34F8A021DE7CE400803","idExterno":"1017","produto":"GG CREDITS","fornecedor":"Jogos","tipoProduto":"ONLINE","tipoNegocio":7,"chaveProduto":"LJTC97R1YADLX5ZXKF0B63418Q","configuracaoId":"P8A1TLYQXRSB3P151GLND3VRS0","dataHoraCliente":"2022-06-27T13:09:40.244Z","valor":"3000"}
{
"estabelecimento":"FC36876DD0B9F34F8A021DE7CE400803",
"idExterno":"1017",
"produto":"GG CREDITS",
"fornecedor":"Jogos",
"tipoProduto":"ONLINE",
"tipoNegocio":7,
"chaveProduto":"LJTC97R1YADLX5ZXKF0B63418Q",
"configuracaoId":"P8A1TLYQXRSB3P151GLND3VRS0",
"dataHoraCliente":"2022-06-27T13:09:40.244Z",
"valor":"3000"
}
Exemplo de RESPONSE:
{
"venda": {
"estabelecimento": {
"cnpjCpf": "95.617.473/0001-49",
"nome": "Homologação Plataforma EGIFT - NÃO MEXER"
},
"produto": {
"fornecedor": {
"nome": "Jogos"
}
},
"transacao": {
"valor": 3000,
"status": "AUTORIZADA",
"idTransacao": "b65d64ae-9935-42c0-97fa-4b2d8a1030ef",
"dataHora": "2022-06-27T11:42:42.000-04:00"
},
"idExterno": "1017"
}
}
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/voucher/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
{"estabelecimento":"FC36876DD0B9F34F8A021DE7CE400803","idExterno":"1017","dataHoraCliente":"2022-06-27T13:09:40.244Z"}
{
"estabelecimento":"FC36876DD0B9F34F8A021DE7CE400803",
"idExterno":"1017",
"dataHoraCliente":"2022-06-27T13:09:40.244Z"
}
Exemplo de RESPONSE:
{
"transacao": {
"status": "CANCELADA"
}
}