Cielo Developer Guide 2.0.3

  • View
    467

  • Download
    0

Embed Size (px)

DESCRIPTION

Cielo Developer Guide 2.0.3 - Payment Gateway Brasil

Text of Cielo Developer Guide 2.0.3

  • Cielo e-Commerce Manual do Desenvolvedor Verso 2.0.3

    1

    207

    e-Commerce

    Manual do Desenvolvedor Verso 2.0.3

  • Cielo e-Commerce Manual do Desenvolvedor Verso 2.0.3

    2

    1 Introduo ........................................................................................................................................................................ 3 1.1 Pblico Alvo .......................................................................................................................................................... 3 1.2 Pr-requisitos tcnicos .................................................................................................................................... 3 1.3 Cielo e-Commerce em 4 passos .................................................................................................................... 3 1.4 Suporte Cielo e-Commerce ............................................................................................................................. 4 1.5 Principais termos utilizados .......................................................................................................................... 4 1.6 Produtos e Bandeiras suportadas ............................................................................................................... 5

    2 Viso geral ........................................................................................................................................................................ 6 2.1 O pagamento no e-commerce ....................................................................................................................... 6 2.2 Caractersticas da soluo .............................................................................................................................. 7

    2.2.1 Consideraes sobre a integrao .................................................................................................... 7 2.3 Versionamento da mensageria e compatibilidade .............................................................................. 8

    2.3.1 Compatibilidade ....................................................................................................................................... 8 2.4 Arquitetura de integrao .............................................................................................................................. 8 2.5 Transao ............................................................................................................................................................... 9

    2.5.1 Criando uma transao ...................................................................................................................... 10 2.5.2 Fluxos de integrao e redirects .................................................................................................... 12 2.5.3 Tipos de retorno .................................................................................................................................... 14

    2.6 Autenticao, nvel de segurana e Chargeback ................................................................................ 16 3 Operaes e configuraes..................................................................................................................................... 20

    3.1 Criao da Transao de Autorizao .................................................................................................... 20 3.1.1 Autorizao Direta ............................................................................................................................... 20 3.1.2 Autorizao Recorrente ..................................................................................................................... 21 3.1.3 Funcionalidades agregadas .............................................................................................................. 23

    3.2 Captura ................................................................................................................................................................. 25 3.2.1 Captura Parcial e Total ....................................................................................................................... 26

    3.3 Consulta ............................................................................................................................................................... 27 3.3.1 Consulta por TID ................................................................................................................................... 27 3.3.2 Consulta por Nmero do Pedido .................................................................................................... 28

    3.4 Cancelamento .................................................................................................................................................... 29 3.4.1 Cancelamento Total e Parcial .......................................................................................................... 29

    4 Testes e Homologao .............................................................................................................................................. 32 4.1 Loja Exemplo ..................................................................................................................................................... 34

    5 Consideraes Finais ................................................................................................................................................ 35 5.1 Regras para leitura do carto na loja ...................................................................................................... 35 5.2 Certificado digital ............................................................................................................................................ 35 5.3 Catlogo de Cdigos de Resposta da Autorizao (LR) .................................................................. 37 5.4 Catlogo de Erros ............................................................................................................................................ 38

  • Cielo e-Commerce Manual do Desenvolvedor Verso 2.0.3

    3

    1 Introduo Bem vindo ao Cielo e-Commerce, a plataforma da Cielo para pagamentos no comrcio eletrnico!

    Este manual fornecer todas as informaes necessrias para realizar com sucesso a integrao da sua loja virtual com o Cielo e-Commerce, permitindo o recebimento de transaes de crdito e dbito com a maior variedade de Bandeiras e funcionalidades do mercado!

    1.1 Pblico Alvo As informaes deste manual so destinadas aos desenvolvedores de software, analistas

    programadores e pblico em geral interessado em aprender como se integrar ao Cielo e-Commerce. Sero abordados assuntos tcnicos e de negcios que visam facilitar o entendimento da soluo para receber pagamentos online.

    1.2 Pr-requisitos tcnicos O mecanismo de integrao com o Cielo e-Commerce bastante simples, de modo que apenas

    conhecimentos intermedirios em linguagem de programao para Web, requisies HTTP/HTTPS e manipulao de arquivos XML, so necessrios para implantar a nossa soluo com sucesso.

    INFORMAO: Em caso de dvidas, entre em contato com nosso Suporte: consulte o item 1.4.

    1.3 Cielo e-Commerce em 4 passos Antes de utilizar o Cielo e-Commerce preciso realizar o credenciamento da sua loja virtual junto

    Cielo e tornar-se nosso cliente!

    INFORMAO: Acesse nosso site: www.cielo.com.br >> Seja um cliente Cielo >> Credenciamento >> Credenciamento e-commerce

    Aps a concluso do credenciamento, recebimento das instrues e da chave de segurana

    preciso desenvolver a integrao, utilizando como guia este manual.

    ATENO: Recomendamos que utilize apenas este manual oficial fornecido pela Cielo, pois orientaes e tutoriais disponveis na Internet no so confiveis e podem estar desatualizadas.

    Por fim, aps o trmino do desenvolvimento, preciso dar incio homologao junto Cielo

    para dar incio operao no ambiente de produo. INFORMAO: Destinamos um captulo inteiro somente sobre o processo de homologao.

  • Cielo e-Commerce Manual do Desenvolvedor Verso 2.0.3

    4

    1.4 Suporte Cielo e-Commerce Aps a leitura deste manual, caso ainda persistam dvidas (tcnicas ou no), a Cielo disponibiliza

    o suporte tcnico 24 x 7 em dois idiomas, atravs dos telefones abaixo:

    +55 4002-9700 (Capitais e Regies Metropolitanas) +55 0800-570-1700 (Demais Localidades)

    o Opo 1 Suporte tcnico; o Opo 2 - Credenciamento e-commerce.

    Email: cieloecommerce@cielo.com.br

    1.5 Principais termos utilizados Para facilitar o entendimento, listamos abaixo um pequeno glossrio com os principais termos

    relacionados ao e-commerce, ao mercado de cartes e adquirncia:

    Autenticao: processo para assegurar que o comprador realmente aquele quem diz ser (portador legtimo), geralmente ocorre no banco emissor com uso de carto com chaves de segurana.

    Autorizao: processo para verificar se uma compra pode ou no ser realizada com um

    carto. Nesse momento, so feitas diversas verificaes com o carto e com o portador (ex.: adimplncia, bloqueios, etc.) tambm neste momento que o limite do carto sensibilizado com o valor da transao.

    Cancelamento: processo para cancelar uma compra realizada com carto.

    Captura: processo que confirma uma autorizao que foi realizada previamente. Somente

    aps a captura, que o portador do carto poder visualiz-la em seu extrato ou fatura.

    Ch