Integrando e2Payments com JavaScript: Um Guia Passo a Passo

O e2Payments oferece uma solução robusta para processamento de pagamentos, e integrá-lo com JavaScript pode ser a chave para proporcionar uma experiência de pagamento eficiente e segura em suas aplicações web. Neste tutorial, vamos explorar passo a passo como realizar essa integração, desde a obtenção das credenciais até a execução de transações bem-sucedidas.

Passo 1: Obtendo Credenciais da API

Antes de começarmos, é fundamental garantir que você tenha as credenciais corretas. Acesse o painel administrativo do https://e2payments.explicador.co.mz/ para obter seu `client_id` e `client_secret`. Essas chaves são essenciais para autenticar suas chamadas à API.

Passo 2: Gerando um Token de Acesso

Utilizando as credenciais, vamos gerar um token de acesso. Envie uma requisição POST para o endpoint `/oauth/token`, incorporando as bibliotecas Axios para JavaScript. Este token será necessário para todas as chamadas subsequentes à API.

javascript
axios.post('https://e2payments.explicador.co.mz/oauth/token', {
  grant_type: 'client_credentials',
  client_id: 'seu_client_id',
  client_secret: 'seu_client_secret'
}).then(function(response) {
  console.log('Token gerado com sucesso:', response.data.access_token);
}).catch(function(error) {
  console.error('Erro ao gerar token:', error);
});

Passo 3: Armazenamento Seguro do Token no Navegador

Para otimizar o desempenho, armazenamos o token no navegador. Utilize métodos seguros para armazenar e recuperar o token, evitando exposição desnecessária. Aqui está um exemplo de como você pode implementar isso:

javascript
function storeTokenInBrowser(token) {
  let expires = addDaysToToken(10); // validade de 10 dias
  document.cookie = "e2payment_token=" + (token || "") + expires + "; path=/";
}

function addDaysToToken(totalDays) {
  // implementação para adicionar dias à data atual
}

// Chame storeTokenInBrowser com o token gerado

Passo 4: Composição de Header e Realização de Transações

A composição correta do Header é crucial para as chamadas à API. Aqui está um exemplo de como você pode estruturar o Header e realizar uma transação c2b (Customer to Business):

javascript
var ENDPOINT_URL = "https://e2payments.explicador.co.mz/v1/c2b/mpesa-payment/{wallet_id}";

var header = {
  "Authorization": "Bearer " + getToken(),
  "Accept": "application/json",
  "Content-Type": "application/json"
};

var payloadC2b = {
  "client_id": "seu_client_id",
  "amount": "30",
  "phone": "848512345",
  "reference": "PrimeiroPagamento"
};

axios.post(ENDPOINT_URL, payloadC2b, {headers: header}).then(function(response) {
  console.log('Transação realizada com sucesso:', response.data);
}).catch(function(error) {
  console.error('Erro ao realizar transação:', error);
});

Conclusão:

Ao seguir estes passos, você estará pronto para integrar o e2Payments com JavaScript em suas aplicações. A segurança robusta, combinada com a eficiência da API, garantirá uma experiência de pagamento tranquila para seus usuários. Experimente e experimente a revolução no processamento de pagamentos online com o e2Payments!