Integração

De TrayCheckout

Conteúdo

Integração TrayCheckout

Com nossas APIs você terá acesso a uma grande quantidade de informações e pode customizar como desejar sua integração.


Manuais

O TrayCheckout disponibiliza diversas integrações que permitem a integração de sistemas legados. Estas integrações podem ser realizadas através de redirecionamentos ou de forma transparente, podendo ser feita a opção de integração a partir do nível de conhecimento do integrador. Disponibilizamos a seguir o manual com informações e os canais de atendimento para suporte no processo de integração entre sistemas.

Manual TrayCheckout - v1.0

Tipos de Integração

O TrayCheckout permite duas formas de integração: POST e API.

Integração com POST

Para a utilização da modalidade POST será necessário muito pouco conhecimento em programação, bastando apenas a inclusão de um código HTML em seu site. Esta modalidade fará com que o seu cliente seja redirecionado para o TrayCheckout, onde finalizará sua compra.


Integracao post.png

Exemplos de Integração via POST

Exemplos de criação de consulta de transação
Botão comprar Botão Comprar gerado pelo TrayCheckout
Botão consultar transação (serviço get_by_token) Formulário de consulta de transação por Token


Integração com API

Para a utilização da modalidade API é necessário conhecimento de programação, pois necessitará a integração de seu sistema com as APIs disponibilizadas pelo TrayCheckout. Esta modalidade tornará o processo de compra transparente para o usuário, sem necessidade de criação de novos cadastros e sem o redirecionamento para um ambiente externo.

Integracao api.png


Exemplos e Bibliotecas de Integração via API

Confira as integrações disponibilizadas pela equipe TrayCheckout.

Exemplos de Integração com API TrayCheckout
  Linguagem     Funcionalidade     Descrição  
  PHP   Consultar transação   OBS: adicione o token de sua loja e da transação para consultar     Baixar  
  PHP   Criar transação (Curl)   OBS: adicione o Token de sua loja     Baixar  
  JAVA   Consultar transação   OBS: adicione o token de sua loja e da transação para consultar     Baixar  
  JAVA   Criar Transação   OBS: adicione o token de sua loja     Baixar  
  JAVA   Notificação de Status   OBS: adicione o token de sua loja     Baixar  
Bibliotecas de Integração com API TrayCheckout
  Linguagem PHP   Biblioteca TrayCheckout PHP (Lib Php)  Instalação    Tutorial explicativo    Demonstração da lib  
  Ruby   Biblioteca TrayCheckout em Ruby (Lib Ruby)  Instalação    Tutorial explicativo     Author: Fernando Hamasaki (prodis)  
  AspNet (C#)   Exemplos de Integração TrayCheckout em C# (AspNet)  Download     Após baixar o arquivo, descompacte e abra o projeto no Visual Studio. Tem exemplos para criar, consultar e notificar transação. Além de um exemplo para simular parcelamento de cartão. 

Módulos para Sites Terceiros

O TrayCheckout possui módulos prontos para alguns sistemas de terceiros. Esses módulos são desenvolvidos internamente ou através de parceiros, e possuem diversos testes para garantir a sua compatibilidade com as versões abaixo indicadas.

Abaixo são disponibilizados os links para os manuais dos módulos disponíveis:

Módulos disponíveis
Manual módulo Magento - v1.0 Loja Magento de demonstração
Manual módulo PrestaShop - v1.0 Loja Prestashop de demonstração
Manual módulo OpenCart - v1.0 Loja OpenCart de demonstração

Plataformas Parceiras

É rápido e simples disponibilizar pagamento para sua loja virtual. Veja as plataformas parceiras que já contam com integração TrayCheckout.

Veja o funcionamento do módulo em nossas lojas modelo:


Lojas de demonstração
Loja de demonstração Webstore da Locaweb com integração TrayCheckout  Visualizar Webstore
Loja de demonstração da Tray com integração TrayCheckout  Visualizar Loja Tray

Para disponibilizar o TrayCheckout em sua loja virtual da Tray ou Webstore, basta copiar o token de integração em sua conta TrayCheckout e configurar na área administrativa da plataforma de seu commerce.

O token pode ser obtido através de: [[1]]

NAS – Notificação Automática de Status

O TrayCheckout pode comunicar com sua aplicação a cada alteração de status de uma transação, fazendo com que seu sistema acompanhe todo o fluxo de status e esteja sempre atualizado quanto a situação da transação. É necessário configurar uma url que receberá a chamada, processará os dados recebidos, e em seguida irá obter mais detalhes da transação através de uma API específica. Esse parâmetro está disponível em ambas as integrações (POST ou API) e chama-se url_notification. A notificação será realizada através de um POST, que espera receber o retorno “HTTP 200” de sua aplicação. Caso a página esteja fora do ar ou com algum outro erro e não retorne “HTTP 200”, serão feitas novas tentativas a cada 12 horas durante 3 dias.

Notificacao automatica.png

O TrayCheckout irá realizar o POST com as seguintes informações:

Post de Notificação Automática de Status
token_transaction Token da transação

Após receber esta informação, deverá ser feita a consulta pelas informações completas da transação, através do método de consulta da transação pelo token:

Endereço da API
Ambiente de Testes https://api.sandbox.traycheckout.com.br/v2/transactions/get_by_token
Ambiente de Produção https://api.traycheckout.com.br/v2/transactions/get_by_token
Protocolo Rest/HTTP

Esta API deve receber as seguintes informações:

Dados de Entrada Obrigatório Formato / Tamanho Max Descrição
token_account Sim Texto / 15 Token de identificação do vendedor
token_transaction Sim Texto / 32 Token de identificação da transação


Tabelas Auxiliares

Algumas das APIs do TrayCheckout retornam códigos específicos para alguns “tipos” de dados. Abaixo listamos os códigos disponíveis.


Status da Transação
  4     Aguardando Pagamento  
  6     Aprovada  
  7     Cancelada  
  24     Em Contestação  
  87     Em Monitoramento  
  88     Em Recuperação  
  89     Reprovada  


Formas de Pagamento
  2     Diners  
  3     Visa  
  4     Mastercard  
  5     American Express  
  6     Boleto Bancário  
  7     Itaú Shopline (Transferência)  
  14     Peela  
  15     Discover  
  16     Elo  
  18     Aura  
  19     JCB  
  22     Transf. Online Bradesco  
  23     Transf. Online Banco do Brasil  

Qualquer dúvida de integração, entrar em contato através do email integracao@traycheckout.com.br

Ferramentas pessoais