HOLDER E CUSTOMER:

Holder é o proprietário do cartão (de crédito ou débito). Customer é o cliente/usuário do sistema de seu estabelecimento ou e-commerce.

TRANSAÇÃO COM CAPTURA AUTOMÁTICA:

A captura automática é uma forma bem simples para lançar uma transação.

Utilizando-a, você pré-autoriza e captura o valor da compra.

Para utilizá-la é apenas um paramento na API – CardPayments(post) capture=true. A api retornando o status 200 já significa que a cobrança será lançada na fatura do seu cliente.

Há também a possibilidade de fazer ambas as ações separadamente: fazer uma pré-autorização e depois fazer uma ou várias capturas do(s) valor(es), que efetivamente cairão na fatura do seu cliente. Segue abaixo um modelo de negócio que explica como funciona a pré-autorização e a captura.

TRANSAÇÃO DE PRÉ-AUTORIZAÇÃO:

Transações de pré-autorização também são conhecidas como reserva de limite no cartão de crédito. Elas são um tipo de operação utilizadas, por exemplo por locadoras de veículos e hotéis. O processo é um bloqueio de um valor definido pelo estabelecimento do limite do cartão de crédito para garantir o pagamento de alguma compra ou então funcionar como uma espécie de “seguro” para a empresa. Se o valor pré-autorizado não precisar ser utilizado ele é cancelado ao final da locação do bem ou da estadia. Este tipo de cobrança tem crescido e tem sido utilizada também por empresas de outros setores, como o de saúde.

Veja este exemplo:

As tão esperadas férias chegaram. Para aproveitar o descanso, você reserva uma estadia de alguns dias em um resort paradisíaco. Suponhamos que o limite de seu cartão seja de R$3.500,00 (três mil e quinhentos reais) e que este valor esteja inteiramente disponível em seu cartão. No dia do check in, o resort solicita o seu cartão para fazer uma pré-autorização de R$2.000,00 (dois mil reais). O que acontece nessa prática é o seguinte: o estabelecimento faz um bloqueio temporário de uma parte do seu limite, ficando disponível apenas o valor restante para utilização (R$1.500,00). O objetivo é ter uma garantia da administradora sobre as despesas e possíveis imprevistos que possam acontecer durante a estadia. Se ao final da estadia estiver tudo OK, eles cancelarão a pré-autorização, liberando o limite para você utilizar. Caso dê algum problema o hotel poderá utilizar o valor do limite pré-autorizado para concluir a cobrança da despesa em seu cartão. Vale lembrar que essa é uma operação legal, regulamentada pelas administradoras de cartões.

Na API as pré-autorizações são lançadas no CardPayments(post): capture= false

CAPTURAS:

Tendo uma pré-autorização pode-se então capturar o valor. De forma simplificada, pré-autorização nada mais é do que uma reserva. Captura é o que cairá na fatura do seu cliente. Pode-se por exemplo, ter uma pré-autorização de R$20,00 e uma captura de R$10,00. O que vai cair na fatura do seu cliente o valor de R$10,00. Pode-se por exemplo, ter uma pré-autorização de R$25,00 e uma captura de R$13,00 e outra captura de R$ 7,00. O que será cobrado do seu cliente é o valor final das capturas: R$20,00.

RECORRÊNCIA:

Recorrência é um plano. A cada período (conforme o plano) será lançada a cobrança ao seu cliente que seu estabelecimento definir. A periodicidade pode ser:

Para lançar recorrências, primeiro deve-se ter o plano cadastrado na NIX. Na API, os planos são cadastrados no RecurrencePlans (post). No CardPayments(post) é que a recorrência efetivamente será lançada (no parametro recurrence{}).

Ao lançar uma recorrência, que pode ser por cartão de crédito ou boleto, seu estabelecimento não precisará, por exemplo, lançar mensalmente uma transação para seu cliente. O Nix Gateway faz isso para você. Porém, fique atento aos retornos da API (limite estourado do cartão, o cartão do seu cliente venceu, etc. ) os sucessos e insucessos serão notificados.

TOKENIZAÇÃO DE CARTÃO:

A tokenização consiste em substituir os dados sensíveis do cartão, por um código substituto.

Estes dados são transformados em um código criptografrado (um token), que poderá ser armazenado em banco de dados.

Possuímos o certificado PCI DSS (https://pt.pcisecuritystandards.org/) e com a plataforma Nix,

seu ecommerce poderá oferecer recursos como a compra com 1 clique, preservando a segurança, integridade e a confidencialidade dessas informações.

PEDIDO (ORDER) / MERCHANTORDERID:

Entenda como pedido(order) uma venda no seu ecommerce/sistema. Essa venda tem um número de pedido único (MerchantOrderID).

Você verá muito a referência do MerchantOrderID no Nix, cada transação feita tem um pedido relacionado.

Numa explicação simplificada, num pedido temos:

– Os dados do cliente que está fazendo a compra

– Se é um pedido com recorrência

– A(s) cobrança(s) que foi(foram) realizada(s). Um pedido poderá ter várias cobranças (payments) no caso, por exemplo, de uma recorrência.

GATEWAY DE PAGAMENTO:

É o canal que será utilizado para realizar as transações ( o recebimento de pagamentos ) do seu e-commerce/Loja virtual.

CHARGEBACK:

É quando o proprietário do cartão não reconhece a cobrança em sua fatura. É uma fraude na utilização de cartões de crédito nas compras online, esses lançamentos são cancelados e o lojista fica sem o direito de receber os valores.

CHECKOUT:

É o processo (leia-se “onde”) o cliente irá realizar a concretização da compra online. Geralmente uma única tela com 1(um) ou alguns passos até a efetiva finalização.

TICKET MÉDIO:

É o valor médio das vendas por cliente: divide-se o montante de vendas pelo número de pedidos realizados em um prazo determinado.

SWAGGER:

O Swagger é um projeto composto por algumas ferramentas que auxiliam o desenvolvedor de APIs REST com algumas tarefas como:

• Modelagem da API

• Geração de documentação(legível) da API

• Geração de códigos do Cliente e do Servidor, com suporte a várias linguagens de programação

• Criação de casos de testes

Para isso, o Swagger especifica a OpenAPI, uma linguagem para descrição de contratos de APIs REST. A OpenAPI define um formato JSON com campos padronizados (através de um JSON Schema) para que você descreva recursos, modelo de dados, URIs, Content-Types, Métodos HTTP aceitos e códigos de resposta.