Cliente PaysGator para Node.js

Biblioteca oficial do cliente JavaScript/TypeScript para a API do PaysGator.

Instalação

Instale o pacote utilizando o npm:

npm install paysgator-clientjs

Configuração

Importe e configure o cliente com as suas credenciais:

const { PaysGator } = require('paysgator-clientjs');

const client = new PaysGator({
  apiKey: 'A_SUA_CHAVE_DE_API'
});

Para TypeScript/Módulos ES:

import { PaysGator } from 'paysgator-clientjs';

const client = new PaysGator({
  apiKey: 'A_SUA_CHAVE_DE_API'
});

Utilização

Criar Pagamento

const payment = await client.payments.create({
  amount: 100,
  currency: 'MZN', // ou USD, AOA
  payment_methods: ['MPESA', 'CARD'],
  returnUrl: 'https://exemplo.com/callback',
  fields: ['name', 'email']
});

console.log('Link de Pagamento:', payment.data.checkoutUrl);
console.log('ID da Transação:', payment.data.transactionId);

Confirmar Pagamento (Lado do Servidor)

const confirmation = await client.payments.confirm({
  paymentLinkId: 'id_do_link_de_pagamento',
  paymentMethod: 'MPESA',
  payment_fields: {
      phoneNumber: '841234567' 
  }
});

console.log('Pagamento Confirmado:', confirmation.data.transactionId);

Verificar Saldo

const balance = await client.wallet.getBalance();
console.log('Saldo:', balance.balance, balance.currency);

Obter Transação

const transaction = await client.transactions.get('id_da_transacao');
console.log('Estado da Transação:', transaction.status);

Gerir Subscrições

// Pausar uma subscrição
await client.subscriptions.update('id_da_subscricao', 'pause');

Suporte

Para mais informações ou suporte, por favor contacte info@paysgator.com.