Skip to main content

Tokenização de cartão#

Sobre este guia#

Essa página explica como criar um token de cartão de crédito usando nossa biblioteca LIB JS, e nossa Direct API. Os tokens permitem que os merchants realizem transações sem enviar informações de cartão de crédito para seu backend.

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 em nosso ambiente de testes. Ainda não tem? Fale com um de nossos especialistas em integração
  2. Cartões de crédito ou débito habilitados em seu Dashboard EBANX.

Como funciona#

Existem duas opções para criar um token de cartão de crédito:

  1. LIB JS: Neste método, você gerará o token no front-end do cliente usando nossa LIB JS e enviará o token na chamada da API.
  2. Direct API: Neste método, você usará apenas nossa Direct API para criar o token e adicioná-lo ao seu pagamento.

Crie um token usando a LIB JS#

  1. Adicione a LIB JS à sua página da web

    Nossa LIB JS permite que você colete com segurança informações de cartão de seus clientes. Adicione o seguinte script à sua página da web:

    <script type="text/javascript" src="https://js.ebanxpay.com/ebanx-libjs-latest.min.js"></script>

    E inicialize-o com a configuração do seu merchant:

    EBANX.config.setMode('test'); // production/test
    EBANX.config.setPublishableKey('put your key here'); // Sua chave publica de integracao.
    EBANX.config.setCountry('br'); // Insira o codigo de país. Sempre será br

  2. Crie um token utilizando a função card.createToken

    O trecho abaixo é um exemplo de como criar um token de cartão diretamente no front-end. O token gerado deverá ser enviado ao seu back-end e depois utilizado no pagamento. Ele também poderá ser armazenado e utilizado em compras recorrentes.

    var createTokenCallback = function(ebanxResponse) {
    if (ebanxResponse.data.hasOwnProperty('status')) {
    document.getElementById('status').textContent = 'Success, the token is: ' + ebanxResponse.data.token;
    } else {
    var errorMessage = ebanxResponse.error.err.status_message || ebanxResponse.error.err.message;
    document.getElementById('status').textContent = 'Error ' + errorMessage;
    }
    }
    EBANX.card.createToken({
    card_number: document.getElementById('card-number').value,
    card_name: document.getElementById('card-name').value,
    card_due_date: document.getElementById('card-due-date').value,
    card_cvv: document.getElementById('card-cvv').value
    }, createTokenCallback);

  3. Adicione o token à sua solicitação de pagamento

    Inclua o token que você obteve na etapa anterior ao objeto creditcard na chamada da Direct API.

    curl -X POST 'https://staging.ebanx.com.br/ws/direct' \
    -d 'request_body={
    "integration_key": "your_test_integration_key",
    "operation": "request",
    "payment": {
    "name": "EBANX Token Test",
    "email": "tokenebanx@tokentest.com.br",
    "document": "09997533984",
    "address": "Rua Antônio Achê",
    "street_number": "1800",
    "city": "Ribeirão Preto",
    "state": "SP",
    "zipcode": "14020-600",
    "country": "br",
    "phone_number": "(11) 1111-1111",
    "payment_type_code": "creditcard",
    "merchant_payment_code": "ebanx-payment-token-0001",
    "currency_code": "BRL",
    "instalments": 1,
    "amount_total": 23,
    "creditcard": {
    "token": "token_generated_on_previous_step"
    }
    }
    }

Crie um token usando Direct API#

  1. Chame /ws/token para criar o token

    Usando o endpoint /ws/token, passe os dados do cartão de crédito, país, forma de pagamento e sua chave de integração para gerar um token diretamente através da API:

    curl -X POST 'https://staging.ebanx.com.br/ws/token' \
    -d 'request_body={
    "integration_key": "your_test_integration_key",
    "payment_type_code": "creditcard",
    "country": "br",
    "card": {
    "card_number": "4111111111111111",
    "card_name": "Jose da Silva",
    "card_due_date": "10/2020",
    "card_cvv": "123"
    }
    }'

    Uma chamada bem sucedida retornará o seguinte objeto JSON:

    {
    "status": "SUCCESS",
    "payment_type_code": "visa",
    "token": "token_generated_here",
    "masked_card_number": "411111xxxxxx1111"
    }

  2. Adicione o token à sua solicitação de pagamento

    Inclua o token que você obteve na etapa anterior ao objeto creditcard na chamada da Direct API.

    curl -X POST 'https://staging.ebanx.com.br/ws/direct' \
    -d 'request_body={
    "integration_key": "your_test_integration_key",
    "operation": "request",
    "payment": {
    "name": "EBANX Token Test",
    "email": "tokenebanx@tokentest.com.br",
    "document": "09997533984",
    "address": "Rua Antônio Achê",
    "street_number": "1800",
    "city": "Ribeirão Preto",
    "state": "SP",
    "zipcode": "14020-600",
    "country": "br",
    "phone_number": "(11) 1111-1111",
    "payment_type_code": "creditcard",
    "merchant_payment_code": "ebanx-payment-token-0001",
    "currency_code": "BRL",
    "instalments": 1,
    "amount_total": 23,
    "creditcard": {
    "token": "token_generated_on_previous_step"
    }
    }
    }

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.
Edit this page
Last updated on by Samuell Oliveira