diff --git a/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-checkout.png b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-checkout.png new file mode 100644 index 00000000..8a973099 Binary files /dev/null and b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-checkout.png differ diff --git a/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-payment.png b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-payment.png new file mode 100644 index 00000000..9f0daeb8 Binary files /dev/null and b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-payment.png differ diff --git a/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-platform-application-id.png b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-platform-application-id.png new file mode 100644 index 00000000..6c0d0021 Binary files /dev/null and b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-platform-application-id.png differ diff --git a/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-platform-new-application.png b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-platform-new-application.png new file mode 100644 index 00000000..ba0ed465 Binary files /dev/null and b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-platform-new-application.png differ diff --git a/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-plugin-settings-app-id.png b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-plugin-settings-app-id.png new file mode 100644 index 00000000..dbaccdd9 Binary files /dev/null and b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-plugin-settings-app-id.png differ diff --git a/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-plugin-settings.png b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-plugin-settings.png new file mode 100644 index 00000000..ec99f400 Binary files /dev/null and b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-plugin-settings.png differ diff --git a/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-selecting-payment-option.png b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-selecting-payment-option.png new file mode 100644 index 00000000..3c75d51a Binary files /dev/null and b/docs/ecommerce/woocommerce/__assets__/woocommerce-pix-crediary-selecting-payment-option.png differ diff --git a/docs/ecommerce/woocommerce/__assets__/woocommerce-plugin-settings-v2100.png b/docs/ecommerce/woocommerce/__assets__/woocommerce-plugin-settings-v2100.png new file mode 100644 index 00000000..76a1e920 Binary files /dev/null and b/docs/ecommerce/woocommerce/__assets__/woocommerce-plugin-settings-v2100.png differ diff --git a/docs/ecommerce/woocommerce/woocommerce-crediary.mdx b/docs/ecommerce/woocommerce/woocommerce-crediary.mdx new file mode 100644 index 00000000..3aaebba3 --- /dev/null +++ b/docs/ecommerce/woocommerce/woocommerce-crediary.mdx @@ -0,0 +1,91 @@ +--- +id: woocommerce-crediary +title: Como configurar o plugin OpenPix Crediário com WooCommerce +sidebar_position: 1 +tags: + - ecommerce + - woocommerce + - plugin +--- + +import WooAdvancedSettings from './__components__/woocommerce-advanced-settings.mdx'; + +:::caution Atenção +Este documento espera que você já tenha um ambiente WooCommerce ativo, e uma conta criada na OpenPix +Caso não tenha acesso à plataforma registre-se [aqui](https://app.openpix.com/register?src=wordpress-docs) +::: + +## Instale o Plugin OpenPix na sua instância WooCommerce + +Este documento detalha passos necessários para conectar a sua plataforma de e-Commerce, baseada no WooCommerce, na OpenPix. + +### 1. Instale a OpenPix na sua instância WooCommerce + +[OpenPix For WooCommerce](https://wordpress.org/plugins/openpix-for-woocommerce/) + +![Banner](/img/ecommerce/woocommerce-banner.png) +![Install](/img/ecommerce/woocommerce-plugin-install.png) + +### 2. Configurando o Plugin WooCommerce + +Ao configurar uma nova integração, será possível criar novos pedidos com OpenPix Crediário. + +É necessário ter um [AppID](../../plugin/app-id.md) do tipo _Plugin_ para que seja possível a integração. + +Para tanto, entre na plataforma e crie uma nova aplicação na página de [_Nova API/Plugin_](https://app.openpix.com/home/applications/add) em _API/Plugins > Nova API/Plugin_: + +![Criando uma nova aplicação na plataforma](./__assets__/woocommerce-pix-crediary-platform-new-application.png) + +Ao ser redirecionado para a página de visualizar uma aplicação, copie o _App ID_: + +![Copiando o identificador da aplicação](./__assets__/woocommerce-pix-crediary-platform-application-id.png) + +Vá até a página de configurações do seu plugin, clicando em _Settings Pix Crediary_, para configurar o plugin: + +![Configurações Settings Crediário](./__assets__/woocommerce-plugin-settings-v2100.png) + +Cole o _App ID_ copiado no campo _AppID OpenPix_: + +![Colando o identificador da aplicação](./__assets__/woocommerce-pix-crediary-plugin-settings-app-id.png) + +### 3. Ativando Plugin Brazilian Market + +Para utilizar o OpenPix Crediário e salvar o customer da order na sua cobrança OpenPix é necessário que seja ativado um plugin que possibilite que o cliente informe os campos abaixo no momento da compra. + +- Nome +- Cpf/Cnpj +- Email +- Telefone +- Endereço + +Indicamos o uso do plugin [woocommerce-extra-checkout-fields-for-brazil](https://wordpress.org/plugins/woocommerce-extra-checkout-fields-for-brazil/) para este caso. Uma vez ativado o plugin passará a salvar os clientes que informarem o CPF/CNPJ no momento da compra. + +### 4. Configurações do Plugin no WooCommerce + +Ao acessar as configurações do plugin após os passos anteriores note que o AppID OpenPix ja estará preenchido e você poderá editar o título, descrição e label do botão de compra do plugin. + +Para o tutorial iremos seguir com o titulo **Pagar com OpenPix Crediário** como no print abaixo: + +![Configurações do Pix Crediário](./__assets__/woocommerce-pix-crediary-plugin-settings.png) + +## 5. Realizar Pedido com Pix Crediário no WooCommerce + +Escolha a opção de pagar o pedido usando OpenPix Crediário ou o nome que você escolheu no momento da configuração do plugin. + +![Woocommerce Checkout Crediário](./__assets__/woocommerce-pix-crediary-checkout.png) + +Selecione a opção de pagamento: + +![Selecionando a opção de pagamento](./__assets__/woocommerce-pix-crediary-selecting-payment-option.png) + +Pague a entrada via Pix usando o app do seu banco: + +![Pague o QR Code](./__assets__/woocommerce-pix-crediary-payment.png) + +## 4. Como ver meus logs OpenPix em minha loja WooCommerce/Wordpress + +Você pode visualizar os logs OpenPix em sua loja através dos seguintes passos: + +- 1. Tenha acesso aos arquivos da loja +- 2. Acesse o seguinte path: `/wp-content/uploads/wc_logs` +- 3. Dentro de `wc_logs` você irá encontrar os arquivos de logs da openpix com o seguinte padrão de nome `woocommerce_openpix-2023-01-13-7d609d821235742dd8162bbb0ef84862`