O que é a Integração com a Software Express?
A Software Express é um gateway de pagamento integrado à Uappi, oferecendo aos seus clientes a opção de pagamento via PIX.
O gateway também oferece recursos como consulta, estorno, transação e callback, proporcionando maior flexibilidade nas transações realizadas.
Passo a Passo
1. Obtenha suas Credenciais da Software Express
Para integrar a Software Express à Uappi, siga os passos abaixo para obter suas credenciais:
- Crie uma conta ou faça login na dashboard da Software Express.
- Acesse a seção Dados de Acesso e localize as credenciais necessárias, como o merchant_id e merchant_key.
- Copie as credenciais fornecidas pela Software Express.
- Caso precise de mais informações sobre a configuração, acesse a documentação da API da Software Express.
Configuração do Gateway na Uappi
Após obter suas credenciais, siga os passos abaixo para configurar a Software Express na Uappi:
- Acesse Configurações > Pagamento > Gerenciamento.
- Selecione a opção de edição do gateway Software Express.
Na tela de configuração, preencha os seguintes campos necessários para a integração:
✅ Merchant ID: insira o merchant_id obtido na Software Express.
✅ Merchant Key: insira o merchant_key obtido na Software Express.
✅ Chave Privada de Autenticação: usada para estornos, insira a chave privada gerada a partir da documentação da Fiserv.
- Para gerar essa chave, siga os passos indicados na documentação da Fiserv e entre em contato com o suporte da Fiserv para realizar o cadastro.
✅ Homologação: ativa o ambiente de testes para validar transações antes de ir para o ambiente real.
✅ Alterar status do pedido quando a transação for cancelada: define se o status do pedido será alterado quando a transação for cancelada.
✅ Descrição na fatura: como a origem da compra será apresentada na fatura do cartão.
✅ Observação do pagamento: insira uma mensagem a ser exibida na observação do pagamento.
Configuração de Callback:
Para realizar a configuração de callback, será necessário entrar em contato com o gerente de contas da Fiserv/Software Express para saber o processo específico de configuração.
De início, forneça a URL de callback da sua loja. A URL base para o callback da Uappi é:
https://wapi.webart.com.br/api/v1/run/app/software-express-api/callback?p={{URL_DA_PLATAFORMA_BASE_64}}
A URL de callback é exclusiva para cada loja. Entre em contato com o time de suporte da Uappi para obter a URL de callback específica para a sua loja.
Dicas Úteis
- Ative o ambiente de homologação para testar as transações antes de realizar transações reais.
- Entre em contato com o time da Fiserv/Software Express para configurações de chave privada e callback.
- Certifique-se de que sua chave de autenticação foi gerada corretamente antes de tentar realizar estornos.
Dúvidas Comuns
- Como posso obter o merchant_id e merchant_key? Você pode obter essas credenciais acessando a dashboard da Software Express na seção Dados de Acesso.
- O que é a chave privada de autenticação? A chave privada é usada para estornos e deve ser gerada através da documentação da Fiserv. Para utilizá-la, será necessário realizar o cadastro da chave privada com a Fiserv.
- Preciso configurar um callback? Sim, o callback deve ser configurado entrando em contato com o gerente de contas da Fiserv/Software Express, fornecendo a URL de callback da sua loja.
Precisa de mais ajuda?
Acesse nossa Central de Ajuda para mais conteúdos sobre a Uappi.