GUIA DE INTEGRAÇÃO. Versão Sistema 01.08

Transcrição

1 GUIA DE INTEGRAÇÃO Versão Sistema 01.08

2 ÍNDICE DADOS DA CONTA... 3 CONFIGURAÇÕES DA PLATAFORMA... 3 FORMULÁRIO DE PAGAMENTO... 4 NOTIFICAÇÕES DAS TRANSAÇÕES... 7 CONTATO

3 1 Dados da Conta Link da plataforma: Usuário: seu usuário Senha: sua senha Número do Cartão Teste : CVV Teste : 123 Validade do Cartão Teste : 01/ Configurações da Plataforma Gerando o Token e configurando as URLs de redirecionamento. Acesse a plataforma e clique em Clientes: Clique em Loja Virtual, em GERAR TOKEN, preencha os campos Página de redirecionamento e URL de Notificação e clique em SALVAR. 3

4 3 Formulário de Pagamento Para iniciar uma requisição de pagamento, você precisa criar um formulário, utilizando o método POST, campos do tipo hidden informando os dados do pagamento. URL de pagamentos da plataforma Netcred (parâmetro action do formulário) Descrição dos parâmetros do formulário PARÂMETRO token idpedido iditem_1, iditem_2, etc descricaoitem_1, descricaoitem_2, etc DESCRIÇÃO Token da conta na plataforma. Informa o token da conta na plataforma Netcred. Para gerar o token, acesse sua conta na plataforma, clique em Clientes, clique na aba E-commerce e no botão GERAR TOKEN. Formato: sequência de 32 Identificador do pedido. Identificadores dos itens. Identificam os itens sendo pagos. Descrição dos itens. Descreve os itens sendo pagos. A descrição é o texto utilizado para identificar cada item quando o comprador está finalizando o pagamento. 4

5 Quantidades dos itens. quantidadeitem_1, quantidadeitem_2, etc precoitem_1, precoitem_2, etc valorextra Representam as quantidades de cada item. Valores unitários dos itens. Representam os preços unitários de cada item. Formato: Decimal, com duas casas decimais separadas por ponto (ex ). Valor Extra. Especifica um valor extra que deve ser adicionado ou subtraído ao valor total do pagamento. Esse valor pode representar uma taxa extra a ser cobrada no pagamento ou um desconto a ser concedido, caso o valor seja negativo. Formato: Decimal (positivo ou negativo), com duas casas decimais separadas por ponto (ex ou ). Nome completo do nomecliente cliente Especifica o nome completo do comprador que está realizando o pagamento. do Especifica do comprador que está realizando o pagamento. 5

6 Número do telefone do fonecliente documentocliente Especifica o número do telefone do comprador que está realizando o pagamento. Formato: 2 dígitos para o DDD e de 7 a 9 dígitos para o telefone. Número do documento do Especifica o número do documento (CPF ou CNPJ) do comprador que está realizando o pagamento. Formato: número de 11 a 14 dígitos. Nome da rua do endereço do enderecocliente numerocliente cepcliente bairrocliente Informa o nome da rua do endereço do Número do endereço do Informa o número do endereço do CEP do endereço do Informa o CEP do endereço do Formato: número de 8 dígitos. Bairro do endereço do Informa o bairro do endereço do 6

7 Cidade do endereço do cidadecliente estadocliente Informa a cidade do endereço do Estado do endereço do Informa o estado do endereço do Formato: duas letras, em maiúsculo, representando a sigla do estado correspondente. 4 Notificações das Transações Sempre que o status de uma transação é alterado, a plataforma NETCRED envia os parâmetros da transação para o endereço configurado no campo URL de Notificação. Descrição dos parâmetros de Notificação. PARÂMETRO DESCRIÇÃO Status da transação. Informa o código representando o status da transação. status 1 Aberto 2 Analise 3 Aprovado 4 Cancelado 7

8 Valor bruto da transação. precoparc Informa o valor bruto da transação, sem o acréscimo de juros do parcelamento, se o parâmetro parcelanum for maior que zero, e sem o desconto/acréscimo do parâmetro extra. Formato: Decimal, com duas casas decimais separadas por ponto (ex ). Numero de parcelas da transação. parcelanum Informa o número de parcelas da transação. Valor da parcela da transação. parcela Informa o valor da parcela da transação. Se o parâmetro parcelanum for igual a zero, o valor informado será o mesmo do parâmetro precoparc. Formato: Decimal, com duas casas decimais separadas por ponto (ex ). Valor extra da transação. extra total Informa o valor extra (positivo ou negativo) da transação. Formato: Decimal (positivo ou negativo), com duas casas decimais separadas por ponto (ex ou ). Valor total da transação. Informa o valor total da transação, com acréscimo de juros do parcelamento, se o parâmetro parcelanum for maior que zero, e com o desconto/acréscimo do parâmetro extra. 8

9 Formato: Decimal, com duas casas decimais separadas por ponto (ex ). Código de referência da transação. reference Informa o código que foi usado para fazer referência ao pagamento. Código de referência da transação na plataforma. orderkey Informa o código de referência da transação na plataforma Netcred. Nome completo do nome telefone endereco numero Informa o nome completo do comprador que realizou o pagamento. do Informa o do comprador que realizou o pagamento. Telefone do Informa o telefone do comprador que realizou o pagamento. Formato: 2 dígitos para o DDD e de 7 a 9 dígitos para o telefone. Nome da rua do endereço do Informa o nome da rua do endereço do comprador que realizou o pagamento. Número do endereço do 9

10 Informa o número do endereço do comprador que realizou o pagamento. Cidade do endereço do cidade bairro cep data Informa a cidade do endereço do comprador que realizou o pagamento. Bairro do endereço do Informa o bairro do endereço do comprador que realizou o pagamento. CEP do endereço do Informa o CEP do endereço do comprador que realizou o pagamento. Formato: número de 8 dígitos. Data da notificação Tipo: Data/hora. Formato: YYYY-MM-DDThh:mm:ssTZD 5 Contato: Em caso de dúvidas entre em contato conosco: atendimento@netcredbrasil.com.br Telefone: (47)