1.3.7 • Published 4 years ago

paggcerto-lightbox v1.3.7

Weekly downloads
2
License
MIT
Repository
github
Last release
4 years ago

Paggcerto Lightbox

Plugin JavaScript que permite efetuar pagamentos usando uma janela que se sobrepõe ao aplicativo do vendedor.

Opções disponíveis para instalação

  • Instalar com NPM: npm install paggcerto-lightbox
  • Baixar a última versão no repositório do GitHub
  • Clonar repositório: git clone git@github.com:paggcerto-sa/paggcerto-lightbox.git

Como utilizar o lightbox

O lightbox é iniciado ao invocar o método paggcerto.lightbox() passando sua configuração por parâmetro:

paggcerto.lightbox({
  environment: 'sandbox',
  token: 'AccessToken',
  payment: {
    amount: 189.9,
    replicateAmount: true,
    bankSlipEnabled: true,
    creditEnabled: true,
    debitEnabled: true,
    deviceEnabled: false,
    "card":{
      installments: 10
    },
    "bankSlip": {
      dueDate: "20/12/2018",
      discountDays: 10,
      interest: 0.25,
      fines: 0.25,
      addNoteToInstructions: false,
      permitSecondBankSlip: false,
      note: " ",
      acceptedUntil:1,
      installments: 3,
      discount: 14.28,
      avoidSteps: false
    },
    payers: [{
      sellingKey: null,
      fullName: 'Maria dos Santos',
      taxDocument: '123.123.123-87',
      email: 'maria@email.com',
      mobile: '(79) 99999-9999'
    }]
  },
  abort: function () {
    // Your magic when lightbox is closed before completing the payment
  },
  success: function (paymentResult) {
    // Your magic when payment processing is successfully completed
  },
  fail: function (paymentResult) {
    // Your magic when payment processing fails
  }
})

Acesso ao ambiente

PropriedadeTipoDescrição
environmentenum: sandbox, productionDefine o ambiente: sandbox (ambiente de teste) ou production (ambiente de produção).
tokenstringToken do usuário gerado após a autenticação.

Valor do pagamento

PropriedadeTipoDescrição
amountnumberQuando null habilita o campo de valor para edição.

Método do pagamento

PropriedadeTipoDescrição
bankSlipEnabledboolExibe (true) ou oculta (false) a opção de pagamento com boleto. Valor mínimo: R$ 6,00.
creditEnabledboolExibe (true) ou oculta (false) a opção de pagamento com cartão de crédito. Valor mínimo: R$ 1,00.
debitEnabledboolExibe (true) ou oculta (false) a opção de pagamento com cartão de débito. Valor mínimo: R$ 1,00.
replicateAmountboolIndica se o valor do boleto deve ser replicado ou dividido. Ex.: R$100 em 10 boletos de R$100 (replicado) ou em 10 boletos de R$10 cada (dividido).
deviceEnabledboolIndica se será utilizado dispositivo durante a realização do pagamento.

Comportamento do lightbox quanto aos métodos de pagamento:

  • Se nenhum método de pagamento estiver habilitado o lightbox não iniciará.
  • Se somente um método de pagamento estiver habilitado (true) o lightbox iniciará diretamente nessa opção.
  • As modalidades crédito e débito não suportam múltiplos pagadores. Por esse motivo, mais de um pagador exibe somente a opção de pagamento com boleto, mesmo que as propriedades creditEnabled e debitEnabled estejam definidas como true.
  • Emissão de boleto exige a informação do nome e do CPF/CNPJ do sacado (pagador). Por esse motivo, caso nenhum pagador seja informado, a opção para pagamento com boleto não será exibida, mesmo que a propriedade bankSlipEnabled esteja definida como true.
  • Somente um pagador resulta na emissão de um único boleto (application/pdf). Múltiplos pagadores resulta na emissão de boletos em lote (application/zip), sendo um boleto para cada pagador.
  • Se a propriedade deviceEnabled estiver habilitada, não será possível realizar pagamentos com cartão de forma digitada, apenas com a utilização de um dispositivo.

Pagamento com cartão

PropriedadeTipoDescrição
installmentsnumberLimita a quantidade máxima de parcelas com cartão. Esse limite deve ser de 1 a 12 (opcional).

Pagamento com boleto

PropriedadeTipoDescrição
dueDatestringData do vencimento, essa data pode ser a partir da emissão do boleto e com formato: "DD/MM/YYYY". Este parâmetro possui o limite de 365 dias. Ex.: Um boleto emitido no dia 17/12/2018 o limite máximo para seu vencimento é 17/12/2019 (obrigatório).
discountDaysnumberAté quantos dias, anteriores a data de vencimento, será aplicado o desconto. O número de dias deve ser de 0 a 30 (opcional).
interestnumberValor do juros cobrado ao mês após o vencimento do boleto. Esse valor está em porcentagem e deve ser de 0.25 a 20 (opcional).
finesnumberValor da multa cobrada após o vencimento do boleto. Esse valor está em porcentagem e deve ser de 0.25 a 20 (opcional).
addNoteToInstructionsboolAtiva (true) ou desativa (false) as informações da descrição do pagamento que irão para a instrução do boleto (opcional).
notestringObservações para o pagamento (opcional).
acceptedUntilnumberAté quantos dias, contados a partir da data de vencimento, o boleto poderá ser pago. Esse valor deve ser de 0 a 25 (opcional).
installmentsnumberLimita a quantidade máxima de parcelas com boleto. Esse limite deve ser de 1 a 12 (opcional).
discountnumberValor do desconto. O valor do boleto após o desconto não deve ultrapassar o valor mínimo de R$ 6,00. Esse valor está em porcentagem (opcional).
avoidStepsboolHabilita (true) ou desabilita (false) que ao utilizar o LightBox o(s) boleto(s) seja(m) gerado(s) e seja exibida a tela de geração do(s) boleto(s). Por padrão essa propriedade será false (opcional).

Pagadores

PropriedadeTipoDescrição
sellingKeystringCódigo que associa o seu ID ao pagamento processado pela Paggcerto (opcional).
fullNamestringNome de quem está pagando (pessoa ou empresa).
taxDocumentstringCPF/CNPJ de quem está pagando (obrigátorio). Nos formatos: CPF - 000.000.000-00 e CNPJ - 00.000.000/0000-00
mobilestringCelular do pagador (opcional). Possibilita envio de notificações por SMS. No formato: (99) 99999-9999
emailstringE-mail do pagador (opcional). Possibilita envio de notificações por e-mail.

Eventos (opcionais)

PropriedadeTipoDescrição
abortfunctionExecutado quando o lightbox é encerrado (fechado) antes de concluir o pagamento.
successfunctionExecutado quando o pagamento é finalizado com sucesso.
failfunctionExecutado quando ocorre algum erro no processamento do pagamento.

Como executar localmente

  1. Instale o Node.js
  2. Execute npm install para instalar as dependências do node
  3. Execute npm run build para recompilar os arquivos JavaScript e CSS

Bugs e funcionalidades

Por favor, sinta-se a vontade para iniciar uma issue.

1.3.7

4 years ago

1.3.6

4 years ago

1.3.5

4 years ago

1.3.4

4 years ago

1.3.1

5 years ago

1.3.0

5 years ago

1.2.1

5 years ago

1.2.0

5 years ago

1.1.0

5 years ago

1.0.1

5 years ago

1.0.0

5 years ago

1.0.0-beta.12

5 years ago

1.0.0-beta.11

6 years ago

1.0.0-beta.10

6 years ago

1.0.0-beta.9

6 years ago

1.0.0-beta.8

6 years ago

1.0.0-beta.7

6 years ago

1.0.0-beta.6

6 years ago

1.0.0-beta.5

6 years ago

1.0.0-beta.4

6 years ago

1.0.0-beta.3

6 years ago

1.0.0-beta.2

6 years ago

1.0.0-beta.1

6 years ago