Developer Network

Documentação

Informações e instruções das APIs dos produtos Locaweb.

Redecard Komerci WebService

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.

Operações de Teste (Sandbox)

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.

Exemplo de Requisição e Resposta do Redecard Web Service

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