Documentação para Desenvolvedores

Módulo Oficial Shopify

Shopify é uma plataforma de loja virtual como serviço em cloud.

A integração é feita por meio de um middleware de integração e não é necessário usar código de programação.

Código Fonte

O código fonte do módulo oficial do Boleto Simples para Shopify está disponível em: https://github.com/BoletoSimples/boletosimples-shopify

Informações Técnicas

Autores: rafaelp

Licença: MIT License

Requisitos

  • Conta no Shopify

Instalação

Este módulo não requer instalação.

Configuração

Configuração do Boleto Simples

  1. Gere um Token em Boleto Simples - API;
  2. Crie uma Notificação Automática na sua conta do Boleto Simples para envio de e-mails;
  3. Pronto, conta configurada.

Configuração do Shopify

  1. Crie uma loja no Shopify

  2. Entre na página de Dashboard da sua loja

  3. Inclua um pagamento manual nas configurações de Checkout

    1. Clique em Settings

    2. Clique em Checkout

    3. Selecione Custom payment method na área Manual Payments

    4. No campo Name of the custom payment method coloque: Boleto Bancário

      Atenção: É importante colocar exatamente Boleto Bancário com as maiúsculas e com o acento. Se o termo utilizado for diferente, a integração não irá funcionar. Pode escrever o que quiser nas instruções de pagamento (Enter the payment instructions) como por exemplo: Você irá receber por e-mail um boleto bancário para pagamento.

    5. Clique em Save

  4. Cadastre uma notificação Webhook

    1. Clique em Settings

    2. Clique em Notifications

    3. Clique em Create a webhook na área chamada Webhooks no final da página

    4. Seleciona Order creation em Event

    5. Deixe selecionado JSON em Format

    6. Em URL coloque o endereço:

      http://shopify.boletosimples.com.br/TOKEN

      TOKEN é o token de autenticação do seu usuário no Boleto Simples. Para pegar o Token de Autenticação do seu usuário, acesse o menu Minha Conta > API

      Para escolher a conta de cobrança que será usada na criação do boleto, use:

      http://shopify.boletosimples.com.br/TOKEN/ID_CARTEIRA

      ID_CARTEIRA é o ID da Carteira de Cobrança que será usada para geração do boleto.

    7. Clique em Save webhook

  5. Faça uma compra de teste e verifique se o boleto bancário será gerado na sua conta do Boleto Simples

Observações

Os boletos serão gerados com vencimento para 3 dias após a data do pedido.