-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathabout.html
193 lines (151 loc) · 10 KB
/
about.html
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
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta content="IE=edge,chrome=1" http-equiv="X-UA-Compatible">
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
<title>Sobre Nossa API</title>
<style>
</style>
<link rel="stylesheet" media="screen" href="pub/css/screen.css">
<link rel="stylesheet" media="screen" href="pub/css/screen_overrides.css">
<link rel="stylesheet" media="print" href="pub/css/print.css">
<link rel="stylesheet" media="print" href="pub/css/print_overrides.css">
<link rel="stylesheet" media="screen" href="pub/css/ir-black.css">
<link rel="stylesheet" media="screen" href="pub/css/theme_overrides.css">
<script src="source/javascripts/lib/_jquery.js"></script>
<script src="source/javascripts/lib/_jquery.highlight.js"></script>
<script src="source/javascripts/lib/_lunr.js"></script>
<script src="source/javascripts/lib/_imagesloaded.min.js"></script>
<script src="source/javascripts/lib/_energize.js"></script>
<script src="source/javascripts/app/_lang.js"></script>
<script src="source/javascripts/app/_search.js"></script>
<script src="source/javascripts/app/_toc.js"></script>
<script type="text/javascript">
$(function() {
loadToc($('#toc'), '.toc-link', '.toc-list-h2, .toc-list-h3, .toc-list-h4, .toc-list-h5, .toc-list-h6', 10);
setupLanguages($('body').data('languages'));
$('.content').imagesLoaded( function() {
recacheHeights();
refreshToc();
});
});
window.onpopstate = function() {
activateLanguage(getLanguageFromQueryString());
};
</script>
<meta name="theme-color" content="#F3F7F9" />
<!-- Renderer: Shins v2.4.1-0 -->
</head>
<body data-languages="[]">
<a href="#" id="nav-button">
<span>
NAV
<img src="source/images/navbar.png" class="undefined" alt="Navigation">
</span>
</a>
<div class="toc-wrapper">
<img src="source/images/custom_logo.png" class="logo" alt="Logo">
<div class="search">
<input type="text" class="search" id="input-search" placeholder="Search">
</div>
<ul class="search-results"></ul>
<div id="toc" class="toc-list-h1">
<ul class="toc-list-h1">
<li>
<a href="#sobre-nossa-api" class="toc-h1 toc-link" data-title="Sobre nossa API">Sobre nossa API</a>
<ul class="toc-list-h2">
<li>
<a href="#como-funciona" class="toc-h2 toc-link" data-title="">Como funciona</a>
</li>
<li>
<a href="#postman" class="toc-h2 toc-link" data-title="">Postman</a>
</li>
</ul>
</li>
<li>
<a href="#termos-fundamentais" class="toc-h1 toc-link" data-title="Termos fundamentais">Termos fundamentais</a>
<ul class="toc-list-h2">
<li>
<a href="#pci-compliance" class="toc-h2 toc-link" data-title="">PCI Compliance</a>
</li>
<li>
<a href="#transa--o" class="toc-h2 toc-link" data-title="">Transação</a>
</li>
<li>
<a href="#pagamento" class="toc-h2 toc-link" data-title="">Pagamento</a>
</li>
<li>
<a href="#order" class="toc-h2 toc-link" data-title="">Order</a>
</li>
</ul>
</li>
<li>
<a href="#guidelines" class="toc-h1 toc-link" data-title="Guidelines">Guidelines</a>
</li>
</ul>
</div>
<ul class="toc-footer">
<li><a href="index.html">Voltar para a página inicial</a></li>
</ul>
</div>
<div class="page-wrapper">
<div class="dark-box"></div>
<div class="content">
<h1 id="sobre-nossa-api">Sobre nossa API</h1>
<p>Orders Client API é <a href="https://en.wikipedia.org/wiki/Representational_state_transfer">RESTful</a> e seguimos um padrão para todos os endpoints para deixar a integração mais fácil.</p>
<p>Através de nossa API, é possível verificar as formas de pagamento disponíveis para um determinado valor e após isso, criar links de pagamento. Esse link de pagamento pode ser enviado para o cliente final da maneira que o estabelecimento preferir, para que a transação seja realizada.</p>
<p>Não só criar links de pagamento, mas API também permite que seja consultado status desses links, e caso aprovados, é possível realizar um controle dos pagamentos referentes à essas transações.</p>
<p>Além disso, é utilizado o padrão OpenApi 3.0 e disponibilizamos o <a href="https://www.evoluservices.com/resources/docs/orders-api-docs.json">JSON com a especificação</a>.</p>
<h2 id="como-funciona">Como funciona</h2>
<p>Cada parceiro poderá criar a sua plataforma para fazer chamadas ao nosso API. O diagrama abaixo mostra quais são os passos para realizar uma transação com o link de pagamento.</p>
<p><img src="source/images/diagram.png" alt="Diagrama sequencial"></p>
<h2 id="postman">Postman</h2>
<p>O Postman é uma ferramenta cujo objetivo é testar e desenvolver APIs que utilizam requisições HTTP para extrair, inserir, postar e deletar dados (RESTful APIs). Além disso, ele analisa as respostas da API e as exibe de forma clara e agradável, o Postman também permite a configuração de testes para as Interface de Programação de Aplicações.</p>
<p>Para saber mais informações sobre o Postman, acesse o site do <a href="https://www.postman.com/">Postman</a> que será possível encontrar diversos conteúdos e diversas formas de se utilizar o mesmo.</p>
<p>No Postman, é possível importar Collections que são um conjunto de exemplos de requisições que podem ser utilizadas para fins de teste. Para importá-la clique no botão abaixo:</p>
<p><a href="https://app.getpostman.com/run-collection/5da5c26a20c0e076c7c2"><img src="https://run.pstmn.io/button.svg" alt="Run in Postman"></a></p>
<h1 id="termos-fundamentais">Termos fundamentais</h1>
<p>Alguns termos são fundamentais o entendimento para poder acompanhar com mais qualidade o processo de integração com a Order API.</p>
<h2 id="pci-compliance">PCI Compliance</h2>
<p>PCI Compliance ou PCI DSS (Payment Card Industry Data Security Standard) é a principal certificação de segurança digital e todas as empresas que lidam com transações envolvendo o processamento, armazenamento e transmissão de informações sigilosas, como por exemplo os dados de cartão de crédito, precisam dessa certificação. Ela foi criada pela PCI Security Standards Council, uma entidade formada pelas empresas Visa, Mastercard, American Express, Discover e JCB International.</p>
<p>Para conseguir essa certificação e obter maior eficácia na segurança dos dados dos consumidores a empresa precisa estar em conforme com doze principais requisitos:</p>
<ol>
<li>Instalar e manter uma rede de firewall segura;</li>
<li>Alterar as senhas padrão dadas por fornecedores, visando reduzir os riscos de invasão;</li>
<li>Usar criptografia de dados;</li>
<li>Codificar a transmissão de dados do usuário e informações confidenciais em redes públicas;</li>
<li>Usar e atualizar frequentemente o antivírus;</li>
<li>Desenvolver e manter aplicativos seguros;</li>
<li>Restringir acesso aos dados por parte das empresas;</li>
<li>Atribuir uma identificação única para cada usuário;</li>
<li>Limitar o acesso físico aos dados de cada usuário;</li>
<li>Monitorar os dados dos usuários com regularidade;</li>
<li>Aplicar testes de segurança aos recursos tecnológicos;</li>
<li>Desenvolver e manter uma política de segurança da informação.</li>
</ol>
<p>Essas regras objetivam proteger os estabelecimentos e consumidores de fraudes que envolvam o compartilhamento de dados de cartão a terceiros. As empresas que não se enquadram aos requisitos estabelecidos estão sujeitas ao descredenciamento por parte das operadoras dos cartões de crédito, entre outras medidas cabíveis.</p>
<p>A Evoluservices é certificada anualmente pelo PCI DSS.</p>
<h2 id="transa--o">Transação</h2>
<p>Uma transação financeira é uma ocasião envolvendo de modo geral duas personas, sendo que uma, o vendedor, oferece um produto ou serviço para a segunda, o comprador, que para aquisição do produto/serviço realiza um pagamento em dinheiro em espécie, cheque, cartão de débito/crédito ou qualquer outra forma de pagamento.</p>
<p>No nosso sistema, o link de pagamento se trata de uma transação com um cartão de crédito.</p>
<h2 id="pagamento">Pagamento</h2>
<p>Dada uma transação que foi realizada com sucesso utilizando algum de nossos produtos, o pagamento é o valor que o estabelecimento irá receber referente a essa transação.</p>
<p>O valor desse pagamento se dará de acordo com o plano que o estabelecimento tem acordado conosco.</p>
<h2 id="order">Order</h2>
<p>Uma order é um link de pagamento. Ela pode iniciar uma transação de crédito ou uma recorrência de transações. O link de pagamento terá um valor definido no momento de sua criação e deve ser enviado ao pagador para realizar a transação de fato.</p>
<h1 id="guidelines">Guidelines</h1>
<p>Para que possamos evoluir a API do melhor modo possível, seguimos algumas guidelines. São elas:</p>
<ul>
<li>Evitaremos ao máximo remover ou renomear parâmetros e requisições;</li>
<li>Caso adicionarmos algum parâmetro a mais para ter acesso a novos recursos, ele será opcional e não prejudicará o funcionamento da API.</li>
</ul>
<!-- Renderer: Shins v2.4.1-0 -->
</div>
<div class="dark-box">
<div class="lang-selector">
</div>
</div>
</div>
</body>
</html>