Informações e instruções das APIs dos produtos Locaweb.
Na modalidade Redecard Komerci WebService, o lojista é responsável por capturar os todos os dados.
Na modalidade Redecard Komerci WebService, o lojista é responsável por capturar os todos os dados (incluindo os dados do cartão de crédito) e enviar ao Gateway de Pagamento.
No Redecard Komerci WebService, as informações do pagamento são enviadas diretamente para o Gateway de Pagamento. Assim, essa modalidade de utilização requer que o nó “pagamento” contenha os dados do cartão. Veja um exemplo:
1
2
3
4
5
6
7
8
9
"pagamento":{
"meio_pagamento":"redecard_ws",
"bandeira":"visa",
"numero_cartao":"4012001037141112",
"cartao_codigo_verificacao":"973",
"parcelas":"1",
"tipo_operacao":"credito_a_vista",
"vencimento_cartao":"082015"
}
Para executar transações utilizando AVS (autenticação) basta que as opções de verificação estejam selecionadas no painel e que as informações do comprador sejam enviadas na requisição. Veja um exemplo:
1
2
3
4
5
6
7
8
9
10
11
"comprador":{
"nome":"Nome do comprador",
"documento":"12345678900",
"endereco":"Rua da Casa",
"numero":"1",
"complemento":"Ap 82",
"cep":"09710240",
"bairro":"Centro",
"cidade":"São Paulo",
"estado":"SP"
}
Caso as informações do usuário selecionado não sejam válidas, o Gateway de Pagamento irá retornar o status “Negada” e o fluxo é encerrado.
Caso a captura não ocorra automaticamente, ela deve ser feita em até 2 minutos após a autorização.
Os testes do Komerci Webservice retornam resultado aleatório e não é necessário enviar dados válidos (como número do cartão), basta enviar os dados obrigatórios. Caso o AVS (autenticação) esteja ativado este também terá um retorno aleatório.
A aleatoriedade também independe do status atual da transação, sendo possível capturar uma transação cancelada com sucesso ou cancelar uma transação já cancelada, por exemplo.
Segue abaixo um exemplo de requisição usando a Redecard Web Service:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
{
"token":"3a5bbed0-50d4-012f-8d73-0026bb5a6240",
"transacao":{
"capturar":"true",
"pedido":{
"numero":"12345",
"total":"1.00",
"moeda":"real",
"descricao":"Carrinho de Compras"
},
"pagamento":{
"bandeira":"visa",
"meio_pagamento":"redecard_ws",
"cartao_numero":"4012001037141112",
"cartao_cvv":"973",
"cartao_validade":"082015",
"parcelas":"1",
"tipo_operacao":"credito_a_vista"
},
"comprador":{
"nome":"Nome do comprador",
"documento":"12345678900",
"endereco":"Rua da Casa",
"numero":"1",
"complemento":"Ap 82",
"cep":"09710240",
"bairro":"Centro",
"cidade":"São Paulo",
"estado":"SP"
}
}
Segue abaixo a resposta da requisição acima:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
"transacao": {
"status": "paga",
"meio_pagamento": "redecard_ws",
"numero_pedido": 12345,
"id": 166,
"detalhes": {
"numero_sequencial": "238",
"numero_comprovante_venda": "9844",
"url_comprovante": "https://ecommerce.redecard.com.br/pos_virtual/cupom.asp?DATA=20120315&TRANSACAO=201&NUMAUTOR=8403&NUMCV=9844&FILIACAO=1234567890",
"numero_autorizacao": "8403",
"numero_autenticacao": "9399"
},
"erro": null,
"total": "1.00"
}
}