Escolar Documentos
Profissional Documentos
Cultura Documentos
Manual do Desenvolvedor
Verso 1.1
15/08/2013
SUMRIO
1.
2.
3.
4.
5.
6.
7.
8.
Pgina 2 de 24
1. HISTRICO DE ALTERAES
MeuCheckout - Manual de Integrao e Desenvolvimento
Verso
Data
Descrio
1.0
17/05/2013
Verso inicial
1.1
16/08/2013
Pgina 3 de 24
3. SOBRE O MEUCHECKOUT
O MeuCheckout uma soluo de checkout projetado para aumentar converso, simplificar o processo de
compra, reduzir fraudes e custos operacionais.
Pgina 4 de 24
Veja abaixo a tabela com os parmetros a serem enviados. E logo abaixo algumas instrues de uso dos grupos.
Parmetro
Dados do Pedido
Merchant_ID
Order_Number
Soft_Descriptor
Tipo do
Campo
Tamanho
Obrigatrio
Min
Max
GUID
Sim
Alfanumrico
64
No
Alfanumrico
13
No
Shipping_Type
Numrico
Sim
Cart_N_Name
Nome do produto
Alfanumrico
128
Sim
Descrio do produto
Alfanumrico
256
No
Cart_N_UnitPrice
Numrico
10
Sim
Cart_N_Quantity
Quantidade do produto
Numrico
10
Sim
Cart_N_Type
Numrico
Sim
Cart_N_Code
SKU do produto
Alfanumrico
32
No
Numrico
10
No
No
Cart_N_Description
Carrinho de Compras
Descrio
Cart_N_Weight
Cart_N_ZipCode
Numrico
Pgina 5 de 24
Dados de Frete
Desconto
Discount_Type
Tipo de Desconto
Numrico
Discount_Value
Valor do Desconto
Numrico
Shipping_N_Name
Alfanumrico
128
No
Shipping_N_Price
Numrico
10
No
No
Shipping_ZipCode
Dados do Consumidor
Customer_Name
Customer_Identity
Customer_Email
Customer_Phone
No
Numrico
Alfanumrico
288
No
Alfanumrico
14
No
Alfanumrico
64
No
Numrico
11
No
Descrio
Correios
Frete fixo
Frete grtis
Retirar em mos/loja
Descrio
Material fsico
Digital
Servio
No
Pgina 6 de 24
Carrinho de Compras:
Campos: CART_N_NAME, CART_N_DESCRIPTION, CART_N_UNITPRICE, CART_N_QUANTITY, CART_N_TYPE,
CART_N_CODE, CART_N_WEIGHT, CART_N_ZIPCODE.
Nos campos referentes ao Carrinho onde sero enviados os itens escolhidos pelo Consumidor para compra. Cada
produto/servio dever ser listado nestes campos, com suas devidas informaes.
O N deve ser representado por cada item do carrinho. Exemplo de Carrinho, com uso de Frete Correios:
Produto
Descrio
Preo
Qtde
Tipo
SKU
CART_N
_NAME
CART_N_DES
CRIPTION
CART_N_UN
ITPRICE
CART_N_Q
UANTITY
CART_N
_TYPE
CART_N
_CODE
Peso
ZipCode
CART_N_
WEIGHT
CART_N_Z
IPCODE
FRETE
FRETE
Bermuda
95,00
Material
9100012
500gr
220080-120
Blusa
80,00
Material
9100013
300gr
220080-120
Dados de Frete:
Pgina 7 de 24
Frete Grtis:
Voc deve passar no campo SHIPPING_TYPE o valor 3.
E no precisa mandar os Dados de Frete.
MeuCheckout apresentar junto ao valor total da compra o campo
Frete grtis.
Pgina 8 de 24
Pgina 9 de 24
Dados do Consumidor:
Campos: CUSTOMER_NAME, CUSTOMER_IDENTITY, CUSTOMER_EMAIL, CUSTOMER_PHONE
Estes parmetros no so obrigatrios, no entanto se o seu site j pede que o seu Cliente esteja logado e voc
possui algumas destas informaes, elas podem ser enviadas no Post e sero automaticamente preenchidas na tela
do MeuCheckout, agilizando assim a finalizao da compra por parte do consumidor. Esses campos sero editveis,
e caso seja necessrio, o consumidor poder alter-las.
Pgina 10 de 24
Pgina 11 de 24
Pgina 12 de 24
Tipo do Produto
SKU
Ttulo
Descrio
Preo
Frete
CEP de Origem
Peso(kg)
Valor do Frete
Mtodo de envio
URL
Descrio
Min
Tamanho
Max
Obrigatrio
Sim
50
No
Titulo do Produto
50
Sim
Descrio do Produto
255
Sim
11
14
Sim
Sim
Sim
Sim
Sim
Sim
Sim
Pgina 13 de 24
Exemplo de Boto:
Adicionando o boto na sua pgina HTML voc deve copiar o cdigo HTML do boto criado e colocar no cdigo
HTML do seu site, conforme o exemplo abaixo.
Pgina 14 de 24
6.
URL DE RETORNO
Ao finalizar uma transao, o comprador final poder ser redirecionado para a URL de retorno. Ao clicar no boto
VOLTAR na tela de comprovante de vendas, o comprador ser direcionando para a URL de retorno previamente
cadastrada no BackOffice.
Essa URL cadastrada pelo prprio lojista no Backoffice, na aba configuraes da loja.
Pgina 15 de 24
7. URL DE NOTIFICAO
Ao finalizar uma transao enviado um post com todos os dados da venda para a URL de Notificao cadastrada,
previamente cadastrada no BackOffice.
Essa URL cadastrada pelo prprio lojista no Backoffice, na aba configuraes da loja.
Descrio
Tipo do
Campo
Tamanho
Min
Max
Meucheckout_order_number
Alfanumrico
32
Amount
Numrico
10
Order_Number
Alfanumrico
32
created_date
Alfanumrico
20
Alfanumrico
289
Alfanumrico
14
Customer_Name
Customer_Identity
Nome do consumidor.
Se enviado, esse valor j vem preenchido
na tela do MeuCheckout
Identificao do consumidor (CPF ou CNPJ)
Se enviado, esse valor j vem preenchido
na tela do MeuCheckout
Customer_Email
E-mail do consumidor
Se enviado, esse valor j vem preenchido
na tela do MeuCheckout
Alfanumrico
64
Customer_Phone
Telefone do consumidor
Se enviado, esse valor j vem preenchido
na tela do MeuCheckout
Numrico
11
Shipping_Type
Modalidade de frete
(vide tabela 1)
Numrico
Pgina 16 de 24
Shipping_name
Nome do frete
Alfanumrico
128
Shipping_Price
Numrico
10
Shipping_address_zipcode
Numrico
Alfanumrico
64
64
Shipping_address_district
Shipping_address_city
Alfanumrico
Shipping_address_line1
Endereo de entrega
Alfanumrico
256
Shipping_address_line2
Alfanumrico
256
Shipping_address_number
Numrico
Payment_method_type
Numrico
Payment_method_brand
Numrico
Payment_method_bank
Numrico
Payment_maskedcredicard
Alfanumrico
20
Payment_installments
Nmero de parcelas
Numrico
Payment_antifrauderesult
Numrico
Payment_boletoexpirationdate
Numrico
10
Payment_status
Status da transao
(vide tabela 6)
Numrico
1
2
Valor
Descrio
Correios
Frete fixo
Frete grtis
Retirar em mos/loja
Pgina 17 de 24
Valor
Descrio
Carto de Crdito
Boleto Bancrio
Dbito Online
Carto de Dbito
Tabela 3 Bandeira
Valor
Descrio
Visa
Mastercad
AmericanExpress
Diners
Elo
Valor
Descrio
Banco do Brasil
Bradesco
Valor
Descrio
Baixo Risco
Alto Risco
No Finalizado
Valor
Descrio
Pgina 18 de 24
Boleto
Boleto Vencido
(processo automatico)
EXPIRADO
PENDENTE
Boleto gerado
Boto Conciliar
PAGO
fim
fim
Erro de processamento
NO FINALIZADO
Todo boleto gerado (emitido) aparece com o status de PENDENTE no Relatrio de Pedidos exibido ao lojista
na area do Backoffice. Sua troca de status vai depender de aes manuais.
Possiveis Status do Boleto
PENDENTE boleto emitido pelo processo de transao. Status continuo at alterao manual pelo lojista.
PAGO Status usado quando o boto "Conciliar ativado pelo lojista. Esse status pode ser revertido para
pendente utiliando o Boto Desfazer conciliao.
EXPIRADO Status ativo apos 10 dias da criao do boleto, caso esse no tenha sito conciliado nesse periodo.
Boletos com status EXPIRADO podem ser conciliados.
Pgina 19 de 24
Carto de Crdito
Autorizao Iniciada
Ainda sem confirmao da Cielo
NO AUTORIZADO
EXPIRADO
PENDENTE
AUTORIZADO
fim
fim
Boto Cancelar
Boto Capturar
Erro de processamento
NO FINALIZADO
PAGO
Boto Chargeback
fim
fim
Boto Cancelar
CANCELADO
Boto Capturar
CHARGEBACK
Pgina 20 de 24
Anlise de Fraude
Pedidos AUTORIZADOS sero enviados online, ainda no ato da venda, para ferramenta de Antifraude da
Cybersource para anlise. O resultado desta anlise ser traduzido no campo Indicao AF no Relatrio de
Pedido, para cada pedido.
Esta anlise indicar um BAIXO RISCO ou ALTO RISCO para a venda em questo. Esta sugesto que deve
guiar a deciso de se confirmar a venda ou no. E aparecer da forma abaixo no Detalhe do Pedido.
a.
Captura/Cancelamento manual
b.
Captura Automtica
As vendas AUTORIZADAS, e com BAIXO RISCO no antifraude sero CAPTURADAS automaticamente pelo
sistema.
O status apresentado ser PAGO. Esta venda ser ento confirmada (capturada) na Cielo.
c.
Cancelamento Automtico
As vendas AUTORIZADAS, e com ALTO RISCO no antifraude sero CANCELADAS automaticamente pelo
sistema.
O status apresentado ser PAGO. Esta venda ser ento cancelada (desfeita) na Cielo.
Pgina 21 de 24
Ateno! Voc tem a opo de escolher a melhor integrao para o seu negcio, a captura/cancelamento manual
ou automtico feito diretamente pelo seu backoffice.
Conforme abaixo:
no Detalhe do Pedido.
Pgina 22 de 24
Dbito Online
Transao iniciada
PENDENTE
NO AUTORIZADO
PAGO
fim
fim
Erro de processamento
NO FINALIZADO
Pgina 23 de 24
Pgina 24 de 24