Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

--- integracoes:api-pagamento [05/02/2025 17:42] – [Fluxo de Pagamento por Cartão] sara.valongo
+++ integracoes:api-pagamento [14/10/2025 13:32] (atual) – vivianne.sousa
@@ Linha 9: / Linha 9: @@
 Este documento é direcionado para empresas administradoras de serviços de pagamento por cartão que necessitem integrar o GSAN com seu portfólio de serviços financeiros.
-A API possui o recurso de segurança através de token, facilitando a habilitação e desabilitação de novos parceiros. Utiliza plataforma REST com simples, utilizando JSON como protocolo padrão. </columns>
+A API possui o recurso de segurança através de token, facilitando a habilitação e desabilitação de novos parceiros. Utiliza arquitetura REST em suas APIs. </columns>
 ===== Fluxo de Pagamento por Cartão =====
@@ Linha 15: / Linha 16: @@
 <columns> A seguir o fluxo completo do pagamento descrevendo os processos de autorização, pagamento do compromisso pela credenciada, resposta de autorização e baixa do pagamento pelo movimento arrecadador, até a baixa definitiva no GSAN. </columns>
-<uml t=sequence>
+\\
-@startuml header Ciclo de Pagamento footer Operação da Credenciada title Ciclo de Vida do Pagamento por Cartão na Agência Virtual actor Consumidor #green boundary AgenciaVrtual control GSAN boundary Credenciada boundary OperadoraCartao boundary BancoArrecadador participant "Concessionária \nde Água" as CONCESSIONÁRIA
+<WRAP center round box 100%>
+{{ :integracoes:imagem_documentacao_api_pagamentos.png?1000 |}}
-Consumidor → AgenciaVrtual : Request Authentication<<documento>> AgenciaVrtual → GSAN : Autenticar Usuário GSAN → AgenciaVrtual : CriarSessaoUsuario Consumidor → AgenciaVrtual : Solicitar Negociação de Débitos AgenciaVrtual → Credenciada : Acionar Checkout Credenciada
+</WRAP>
+\\
-alt Ciclo de controle da Credenciada Credenciada → Consumidor : Solicitar dados do Cartão Credenciada → Consumidor : Solicitar escolha de quantidade de parcelas Credenciada → Consumidor : Informar Tarifa da Operação Consumidor → Credenciada : Retornar Informações Credenciada → Consumidor : Solicitar Confirmação das Informações Consumidor → Credenciada : Confirmar Informações Credenciada → OperadoraCartao : Solicitar Autorização da Operadora OperadoraCartao → Credenciada : Retorna Autorização
-group Credenciada Não é Agente Arrecadador Credenciada → BancoArrecadador : Realizar Pagamento Código de Barras BancoArrecadador –> CONCESSIONÁRIA : Realizar Transferência Eletrônica de Fundos Credenciada → Consumidor : Recibo de Pagamento Autorizado Credenciada → GSAN : Pagamento Autorizado <<NSU, Autenticação Mecânica>> BancoArrecadador -[#blue]→ GSAN : Enviar Movimento TXT Tipo G end
-group Credenciada Como Agente Arrecadador Credenciada → CONCESSIONÁRIA : Realizar Transferência Eletrônica de Fundos Credenciada -[#blue]→ GSAN : Enviar Movimento TXT Tipo G Credenciada → Consumidor : Recibo de Pagamento Autorizado Credenciada → GSAN : Pagamento Autorizado <<NSU, Autenticação Mecânica>> end
-end
-GSAN → GSAN: Baixar Pagamentos
-@enduml
-</uml>
 ===== Autenticação =====
-<columns> Os endpoints que nescessitem autenticação serão informados abaixo. Os mesmos precisarão ter as seguintes chaves, **client_secret** e **client_id**, no cabeçalho HTTP, a chave em questão foi gerada para o ambiente de testes:
+<columns> Os endpoints que nescessitem autenticação serão informados abaixo. Os mesmos precisarão ter as seguintes chaves, **client_secret** e **client_id**, no cabeçalho HTTP, a chave em questão deve ser solicitada para o ambiente sandbox alvo da homologação:
 </columns>
@@ Linha 41: / Linha 30: @@
   * **client_id**: CREDENCIADA
   * **client_secret**: <HASH 256b>
 ==== ENDPOINT CONSULTAR DÉBITOS ====
@@ Linha 59: / Linha 50: @@
 <code javascript>
  {matricula:"99999"}
+</code>
+OU
+<code javascript>
+{
+   matricula:"99999",
+   documento:"21469517000102"
+}
 </code>
 <code>
@@ Linha 121: / Linha 119: @@
    matricula:"452812"
 }
+</code>
+OU
+<code javascript>
+{
+   matricula:"452812",
+   documento:"03998285663"
+}
 </code>