node-pagseguro
Integração ao Pagseguro para sistemas usando o Node.js
Instalação
npm install pagseguro
Como usar
Para pagamentos únicos
//Inicializar a função com o e-mail e token var pag pagseguro; pagseguro = ; pag = email : 'suporte@lojamodelo.com.br' token: '95112EE828D94278BD394E91C4388F20' ; //Configurando a moeda e a referência do pedido pag; pag; //Adicionando itens pag; pag; pag; //Configurando as informações do comprador pag; //Configurando a entrega do pedido pag; //Configuranto URLs de retorno e de notificação (Opcional) //ver https://pagseguro.uol.com.br/v2/guia-de-integracao/finalizacao-do-pagamento.html#v2-item-redirecionando-o-comprador-para-uma-url-dinamica pag; pag; //Enviando o xml ao pagseguro pag;
Assinaturas (Pagamentos Recorrentes)
// Inicializa o objeto PagSeguro em modo assinatura var pagseguro = pag = email : 'suporte@lojamodelo.com.br' token: '95112EE828D94278BD394E91C4388F20' mode : 'subscription' ; //Configurando a moeda e a referência do pedido pag ; /*********************************** * Configura a assinatura * ************************************/ //Configurando as informações do comprador pag; // Configurando os detalhes da assinatura (ver documentação do PagSeguro para mais parâmetros) pag; //Configurando URLs de retorno e de notificação (Opcional) //ver https://pagseguro.uol.com.br/v2/guia-de-integracao/finalizacao-do-pagamento.html#v2-item-redirecionando-o-comprador-para-uma-url-dinamica pag ; // Configurando URL de revisão dos termos de assinatura (Opcional) pag; //Enviando o xml ao pagseguro pag;
Modo Sandbox
O modo Sandbox do PagSeguro (hoje, 09/10/2014, em beta) permite o desenvolvedor a testar seu código usando o serviço do PagSeguro sem disparar transações reais mas ainda recebendo notificações. Por enquanto ele só dá suporte a pagamentos padrão, logo para testar assinaturas ainda é necessário realizar uma transação real.
Para utilizar o modo Sandbox, basta inicializar a biblioteca com a opção mode : 'sandbox'
como no exemplo abaixo e utilizá-la para gerar pagamentos avulsos.
// Inicializa o objeto PagSeguro em modo assinatura var pagseguro = pag = email : 'suporte@lojamodelo.com.br' token: '95112EE828D94278BD394E91C4388F20' mode : 'sandbox' ;
É preciso gerar um token específico para o modo Sandbox na Página do Sandbox do PagSeguro
Changelog
- v0.1.0 - Assinaturas no PagSeguro
- Novo construtor aceita um objeto de configuração ao invés dos argumentos de e-mail e token. A maneira antiga ainda é válida, mas está obsoleta e gerará um aviso no console.
- A configuração aceita três modos de pagamento (atributo
mode
):'payment'
: Pagamento único padrão do PagSeguro (Padrão)'subscription'
: Modo de assinatura para pagamentos recorrentes'sandbox'
: Modo de testes do PagSeguro (ver https://sandbox.pagseguro.uol.com.br/)
- Nova função para configurar assinaturas:
pag.preApproval(config)
- Caso a função
addItem()
seja chamada em modosubscription
, é levantada uma exceção - Caso a função
preApproval()
seja chamada em modopayment
ousandbox
, é levantada uma exceção - Caso a função
setReviewURL()
seja chamada em modopayment
ousandbox
, é levantada uma exceção