Como configurar a integração com a Software Express na Uappi?

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:

1. Crie uma conta ou faça login na dashboard da Software Express.
2. Acesse a seção Dados de Acesso e localize as credenciais necessárias, como o merchant_id e merchant_key.
3. Copie as credenciais fornecidas pela Software Express.
4. 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:

1. Acesse Configurações > Pagamento > Gerenciamento.
2. 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.