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 [email protected]: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: '[email protected]',
      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

| Propriedade | Tipo | Descrição | | ------------- | -------------------------------- | ----------------------------------------------------------------------------------------- | | environment | enum: sandbox, production | Define o ambiente: sandbox (ambiente de teste) ou production (ambiente de produção). | | token | string | Token do usuário gerado após a autenticação. |

Valor do pagamento

| Propriedade | Tipo | Descrição | | ----------- | -------- | ---------------------------------------------------- | | amount | number | Quando null habilita o campo de valor para edição. |

Método do pagamento

| Propriedade | Tipo | Descrição | | ------------------ | ------ | ---------------------------------------------------------------------------------------------- | | bankSlipEnabled | bool | Exibe (true) ou oculta (false) a opção de pagamento com boleto. Valor mínimo: R$ 6,00. | | creditEnabled | bool | Exibe (true) ou oculta (false) a opção de pagamento com cartão de crédito. Valor mínimo: R$ 1,00. | | debitEnabled | bool | Exibe (true) ou oculta (false) a opção de pagamento com cartão de débito. Valor mínimo: R$ 1,00. | | replicateAmount | bool | Indica 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). | | deviceEnabled | bool | Indica 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

|Propriedade | Tipo | Descrição | ------------- | -------- | ------------------------------------------------------------------------------ | | installments | number | Limita a quantidade máxima de parcelas com cartão. Esse limite deve ser de 1 a 12 (opcional).|

Pagamento com boleto

|Propriedade | Tipo | Descrição | ------------- | -------- | ------------------------------------------------------------------------------ | | dueDate | string | Data 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). | | discountDays | number| Até quantos dias, anteriores a data de vencimento, será aplicado o desconto. O número de dias deve ser de 0 a 30 (opcional). | | interest | number| Valor 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).| | fines| number | Valor da multa cobrada após o vencimento do boleto. Esse valor está em porcentagem e deve ser de 0.25 a 20 (opcional).| | addNoteToInstructions | bool | Ativa (true) ou desativa (false) as informações da descrição do pagamento que irão para a instrução do boleto (opcional).| | note | string |Observações para o pagamento (opcional).| | acceptedUntil | number| Até quantos dias, contados a partir da data de vencimento, o boleto poderá ser pago. Esse valor deve ser de 0 a 25 (opcional).| | installments | number |Limita a quantidade máxima de parcelas com boleto. Esse limite deve ser de 1 a 12 (opcional). | | discount | number | Valor 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).| | avoidSteps | bool | Habilita (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

| Propriedade | Tipo | Descrição | | ------------- | -------- | ------------------------------------------------------------------------------ | | sellingKey | string | Código que associa o seu ID ao pagamento processado pela Paggcerto (opcional). | | fullName | string | Nome de quem está pagando (pessoa ou empresa). | | taxDocument | string | CPF/CNPJ de quem está pagando (obrigátorio). Nos formatos: CPF - 000.000.000-00 e CNPJ - 00.000.000/0000-00 | | mobile | string | Celular do pagador (opcional). Possibilita envio de notificações por SMS. No formato: (99) 99999-9999 | | email | string | E-mail do pagador (opcional). Possibilita envio de notificações por e-mail. |

Eventos (opcionais)

| Propriedade | Tipo | Descrição | | ----------- | ---------- | -------------------------------------------------------------------------------- | | abort | function | Executado quando o lightbox é encerrado (fechado) antes de concluir o pagamento. | | success | function | Executado quando o pagamento é finalizado com sucesso. | | fail | function | Executado 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.