Parcelamento

Sobre este guia

Essa página explica como configurar, utilizar as parcelas e calcular as taxas de juros aplicadas nas mesmas. As prestações são um plano de pagamento aplicado a uma compra. Em vez de pagar diretamente, os clientes latino-americanos têm uma forte preferência por pagar por uma compra em pacotes espalhados ao longo dos meses.

Se você ainda não está integrado com EBANX Direct API, dê uma olhada neste guia básico. Não tem certeza se EBANX Direct API é a melhor opção para seu e-commerce? Por favor, fale com um de nossos especialistas.

O que você vai precisar

Antes de iniciar sua integração, certifique-se de ter:

1. Uma conta de testes em nosso ambiente Staging. Ainda não tem uma conta? por favor entre em contato com nossos especialistas em integração;
2. Método de pagamento com cartão de crédito configurado em seu Dashboard EBANX.
3. Parcelas habilitadas em sua conta. Entre em contato com seu gerente de conta e nossa equipe de integração para obter mais detalhes.

Como funciona

1. Aplicar taxas de juros

   Conforme descrito em seu contrato, cada número de parcela tem sua própria taxa de juros. Você pode usar os valores deste contrato para calcular o valor final. Antes de enviar a solicitação de pagamento para a EBANX, é necessário calcular o valor final do pagamento com base no número da parcela escolhida pelo cliente.

   Aqui está um exemplo de cálculo: amount = (((interest_rate + 100) / 100) * (orderTotal));

   info

   A API Direta do EBANX prevê o valor final, com taxas de juros, portanto, certifique-se de calculá-lo antes de enviar sua solicitação ao EBANX Direct API.

   Se você está trabalhando com um módulo de e-commerce, como WooCommerce e Magento, você pode notar que alguns deles têm a opção de colocar a taxa de juros manualmente nas configurações do módulo. Você deve manter esse número 0 (zero), pois aplicará a taxa de juros a cada parcela por código.

2. Envie o pedido de pagamento parcelado

   Você pode usar as parcelas de maneiras diferentes, dependendo do método de integração que está usando:

   Página de pagamento usando uma faixa de parcelamento

   Este parâmetro de parcelamento pode ser uma faixa de valores que você oferece ao seu cliente. A faixa será o número de parcelamento mínimo e máximo (1-12, 1-6, 1-3, etc).

   Here's an example:

   curl -X POST 'https://staging.ebanx.com.br/ws/request' \

   -d 'integration_key=your_test_integration_key' \

   -d 'name=José Silva' \

   -d 'email=josesilva@example.com' \

   -d 'country=br' \

   -d 'payment_type_code=_creditcard' \

   -d 'merchant_payment_code=84e886adea7' \

   -d 'currency_code=BRL' \

   -d 'instalments=1-12' \

   -d 'amount=100'

   Página de pagamento usando um valor bloqueado

   Como alternativa, você pode enviar um valor bloqueado que será usado em sua solicitação.

   curl -X POST 'https://staging.ebanx.com.br/ws/request' \

   -d 'integration_key=your_test_integration_key' \

   -d 'name=José Silva' \

   -d 'email=josesilva@example.com' \

   -d 'country=br' \

   -d 'payment_type_code=_creditcard' \

   -d 'merchant_payment_code=84e886adea7' \

   -d 'currency_code=BRL' \

   -d 'instalments=6' \

   -d 'amount=100'

   EBANX Direct API

   Quando estiver usando a API Direta os seguintes parâmetros são obrigatórios para métodos de pagamento brasileiros:

   curl -X POST 'https://staging.ebanx.com.br/ws/request' \

   -d 'request_body={

   "integration_key": "your_test_integration_key",

   "operation": "request",

   "payment": {

   "name": "José Silva",

   "email": "jose@example.com",

   "document": "853.513.468-93",

   "address": "Rua E",

   "street_number": "1040",

   "city": "Maracanaú",

   "state": "CE",

   "zipcode": "61919-230",

   "country": "br",

   "phone_number": "8522847035",

   "payment_type_code": "visa",

   "merchant_payment_code": "9e3775c2772",

   "currency_code": "BRL",

   "instalments": 3,

   "amount_total": 100,

   "creditcard": {

   "card_number": "4111111111111111",

   "card_name": "José Silva",

   "card_due_date": "12/2019",

   "card_cvv": "123"

   }

   }

   }'

Perguntas frequentes sobre parcelamento

1. Preciso enviar a taxa de juros do parcelamento na solicitação de pagamento?

   Não, basta calcular o valor final com a taxa de juros e enviar para a EBANX o valor final e o parcelamento escolhido.

2. Preciso cobrar do cliente mensalmente para aplicar as parcelas?

   Não, o banco do cliente fará as cobranças.

3. Posso aplicar o parcelamento em qualquer meio de pagamento?

   Não, apenas pagamentos com cartão de crédito têm esse recurso.

4. Preciso usar estritamente os valores das taxas de juros que estão no meu contrato?

   As taxas de juros do seu contrato são as que serão cobradas no parcelamento do seu acordo, por isso recomendamos ao nosso lojista que as utilize. Mas você pode optar por aplicar o valor da taxa de juros que desejar.

Obtendo Ajuda

Nós esperamos que este artigo tenha sido esclarecedor, mas caso não tenhamos tirado suas dúvidas você tem as seguintes opções para continuar buscando respostas:

• Se você ainda não é nosso parceiro e deseja saber mais sobre nossos preços e condições, entre em contato com nossa equipe comercial.
• Caso você já seja nosso parceiro, entre em contato com nossa equipe de suporte em faleconosco@ebanxpay.com.