Opção Lightbox

Com a opção Lightbox, você pode customizar a página de finalização da compra com a identidade da sua loja, sem alterar a URL no navegador do cliente. Ao clicar em fechar o carrinho, aparece um lightbox na página do seu site para que o comprador preencha os dados para pagamento.

Integração com Checkout

Passo 1: Adicionar uma tag <script> para inserção do código de chamada ao Lightbox em JavaScript

<script>
        (function(d, s, id){
                var js, fjs = d.getElementsByTagName(s)[0];
                if (d.getElementById(id)) return;
                js = d.createElement(s); js.id = id;
                js.src = "https://checkout.mundipagg.com/v1/lightbox.js";
                fjs.parentNode.insertBefore(js, fjs);
            }(document, 'script', 'mundipagg-lightbox'));
</script>

Passo 2:
Quando o comprador acessar o carrinho você deverá realizar uma requisição ao endpoint de criação de pedido contendo o objeto payments com o campo payment-method : checkout. Além disso, inclua na requisição um objeto checkout com as informações referentes ao pagamento Saiba mais sobre o objeto Checkout.

{
   "items":[...],
   "customer":{...},
   "payments":[
      {   
         "amount" : 3000,
         "payment_method":"checkout",
         "checkout": {
            "expires_in":120,
            "billing_address_editable" : false,
            "customer_editable" : true,
            "accepted_payment_methods": ["credit_card"],
            "success_url": "https://www.mundipagg.com",
            "credit_card": {...}
         }
      }
   ]
}

A resposta da requisição de criação de pedido conterá um objeto checkouts com o campo id. Este id tem o formato chk_XXXXXXXXXXXXXXXX e representa o token do checkout.

{
    "id": "or_GqAlNNOsDLcAlvbP",
    "code": "LKKMFJPU9M",
    "amount": 3000,
        ...
    "checkouts": [
        {
            "id": "chk_ON0Q6MU8EIWGY386",
            "amount": 3000,
            "status": "open",
            "success_url": "https://www.mundipagg.com",
            "payment_url": "https://api.mundipagg.com/checkout/v1/orders/chk_ON0Q6MU8EIWGY386",
            "customer_editable": true,
            "billing_address_editable": true,
            "skip_checkout_success_page": false,
            "created_at": "2018-03-28T18:48:49Z",
            "updated_at": "2018-03-28T18:48:49Z",
            "expires_at": "2018-03-28T20:48:49Z",
            "accepted_payment_methods": ["credit_card"],
            "customer": {...},
            "credit_card": {...},
            "billing_address": {...},
            "shippable": false,
            "currency": "BRL",
            "metadata": {...}
        }
    ]
}

Este token deverá ser utilizado pelo Front-End da sua aplicação, conforme descrito no passo 3.

❗️

ATENÇÃO

O envio da requisição de criação de pedido com checkout deverá ser realizada internamente nos servidores da sua aplicação (Back-End), evitando que o Front-End exponha a Chave de API do lojista.

Passo 3: De volta ao carrinho, uma tag <a>, deverá ser adicionada que conterá o botão de chamada do Lightbox, de acordo com a configuração.

<a data-mundicheckout="lightbox" data-mundicheckout-token="chk_kLPG7B3IaNcNOWny"
data-mundicheckout-default>Pagar</a>

Esta tag recebe as propriedades para configuração, sendo elas:

Nome

Descrição

data-mundicheckout

Define o modo que será apresentado o checkout. O valor padrão é "lightbox".

data-mundicheckout-token

Token gerado na criação do pedido.

data-mundicheckout-default

Se for colocado dá ao elemento <a> de configuração um estilo padrão de botão.

Você deverá atribuir dinamicamente ao parâmetro data-mundicheckout-token deste botão o token do checkout, criado no Passo 2. Ao clicar em Pagar o Lightbox da Mundipagg será apresentado ao comprador, sem a necessidade de redireciona-lo à outra página.