# Shopify

## Crear aplicación privada

Para comenzar, será necesario crear una aplicación de desarrollo privado con el nombre "Bitnovo Pay". Para crearla accederemos a **Configuración > Aplicaciones y canales de ventas > Desarrollar Aplicaciones > Crear una aplicación**, e introducimos el nombre indicado previamente.

<figure><img src="/files/KX0I6z4rmtEDvrOxgglH" alt=""><figcaption><p>Creación de aplicación de desarrollo privado</p></figcaption></figure>

Una vez creada, procedemos a configurarla de la siguiente manera:&#x20;

* Accedemos a **Configuración > Integración de la API del panel** y deberemos editar la configuración. y marcar `write_orders`, `read_orders`, `write_draft_orders` y `read_draft_orders`.&#x20;

<figure><img src="/files/jGpUP4uWMmu7SMpslDJt" alt=""><figcaption></figcaption></figure>

* Una vez hayamos configurado los permisos procedemos a instalar la aplicación. Y guardamos el Token de acceso de la API del panel de control. Este Token lo encontraremos en el menú Credenciales de la API y es **muy importante** guardarlo porque no nos dejará volver a mostrarlo.

<figure><img src="/files/I4osld4iC8OVE0UnyrFX" alt=""><figcaption></figcaption></figure>

## Añadir pago manual &#x20;

Configuraremos un método de pago manual accediendo a **Configuración > Pagos > Añadir Métodos de pago manual**. Lo denominamos "Bitnovo Pay - Pago con Criptomonedas" **(MUY IMPORTANTE: denominarlo con ese nombre exáctamente)** y rellenamos las casillas con los siguientes textos.&#x20;

* Detalles adicionales

"IMPORTANTE: Introduzca su correo electrónico en los datos de su pago. Recibirá un email para completar el proceso de pago." &#x20;

* Instrucciones de pago

"Le hemos enviado un email a su dirección de correo electrónico para que pueda completar el pago de este pedido."

<figure><img src="/files/NblLZLleC3TrWo3XTqL3" alt=""><figcaption></figcaption></figure>

## Configurar Webhooks &#x20;

A continuación, configuraremos los Webhooks necesarios para que apunten a la URL proporcionada por Bitnovo Pay. Accedemos a **Configuración > Notificaciones > Webhooks > Crear webhook**. Seleccionamos el evento “Creación de pedido”, formato JSON y la URL proporcionada por Bitnovo Pay. Seleccionar la versión 2024-10.

* Es fundamental guardar la clave secreta generada por Shopify, ya que se utilizará para firmar los Webhooks y garantizar la seguridad de las comunicaciones.  La URL que debemos introducir es la siguiente: *<https://shopify.bitnovo.com/order/create>*

<figure><img src="/files/XBgCdxq9heHi5lTR0ZkM" alt=""><figcaption></figcaption></figure>

## Obtener credenciales &#x20;

Una vez completada la configuración, será necesario proporcionar a Bitnovo Pay los siguientes datos: &#x20;

* El dominio de nuestra tienda en Shopify. &#x20;
* La clave de firma generada por Shopify, utilizada para firmar los Webhooks.&#x20;
* El Token de acceso de la API del panel de control (\*importante guardar).
* Divisa por defecto en el caso de que el comercio utilice una que Bitnovo Pay no posea.
* Si queremos que Bitnovo almacene los datos de nuestros clientes para poder verlos en el detalle de pago del panel de Bitnovo Pay.

Estos datos los podemos proporcionar en el panel de Bitnovo Pay **Configuración > Comercion > Dispositivos > Editar el dispositivo de tu elección.**

<figure><img src="/files/z0wY1Z9Qu4i0Wh7Yfgqf" alt=""><figcaption></figcaption></figure>

### Flujo de Shopify con Bitnovo Pay

Para garantizar un proceso de pago seguro y eficiente en Shopify utilizando Bitnovo Pay, es obligatorio que el cliente proporcione un correo electrónico válido al rellenar su datos de compra. Este correo es crucial para la comunicación durante el flujo de pago.

## **Flujo del Proceso de Pago con Bitnovo Pay:**

1. **Selección del Método de Pago**\
   El cliente selecciona **Bitnovo Pay** como método de pago en la tienda Shopify.
2. **Recepción de un Correo Electrónico**\
   Una vez seleccionado Bitnovo Pay, el cliente recibirá un correo electrónico con un enlace para completar el pago.
3. **Pago Externo y Confirmación**\
   Al hacer clic en el enlace del correo, el cliente será redirigido a la plataforma de Bitnovo Pay para completar la transacción.
4. **Sincronización Automática con Shopify**\
   Una vez que el cliente complete el pago en Bitnovo Pay, el pedido se marcará automáticamente como pagado en Shopify. Este proceso asegura una integración fluida entre ambas plataformas.
5. **Redirección Final**\
   Tras completar el pago, el cliente será redirigido nuevamente a la tienda Shopify para continuar navegando o recibir la confirmación final del pedido.

**Notas Importantes:**

* El correo electrónico asegura que el cliente pueda acceder de manera eficiente al enlace de pago y recibir notificaciones importantes.
* La sincronización automática entre Bitnovo Pay y Shopify minimiza la necesidad de acciones manuales, mejorando la experiencia del usuario y del administrador de la tienda.

Este flujo es diseñado para ofrecer seguridad, comodidad y compatibilidad con las funcionalidades de Shopify y Bitnovo Pay.<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bitnovo.gitbook.io/pay-es/bitnovo-pay/integraciones/shopify.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.