Shopify Plugin

Shopify does not allow custom payment plugins on its standard plans. The integration with B4bit Pay is done via a manual payment method + an order creation webhook handled by the B4bit infrastructure.

1. Create a private app in Shopify

1. Go to Settings → Apps and sales channels → Develop apps → Create an app.
2. Name the app: B4bit Pay.
3. Enable the following permissions:
   • write_orders
   • read_orders
   • write_draft_orders
   • read_draft_orders
4. Take note of the API access token from the dashboard. It cannot be retrieved later — if you lose it, you will need to regenerate the app.

2. Configure the manual payment method

1. Go to Settings → Payments → Add manual payment method.
2. Exact name required:

   B4BiT Pay - Pago con Criptomonedas

3. In Additional details, set:

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

4. In Payment instructions:

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

3. Configure the webhook in Shopify

Point Shopify to the B4bit service that receives the orders.

1. Go to Settings → Notifications → Webhooks.
2. Create a new webhook with:
   • Event: Order creation
   • Format: JSON
   • Version: 2024-10 (or the most recent compatible)
   • URL: https://shopify.b4bit.com/order/create
3. Save the secret key generated by Shopify (you will need it in the next step).

4. Provide credentials to B4bit Pay

Open Settings → Merchant → Devices → Edit device and enter:

1. Domain of your Shopify store (for example mystore.myshopify.com).
2. Webhook signing key (the one generated in step 3).
3. API access token (from step 1).
4. Default fiat currency (if it is not available in B4bit Pay).
5. Option for customer data storage.

Payment flow

1. The customer chooses B4bit Pay at the Shopify checkout.
2. Shopify creates the order and notifies shopify.b4bit.com.
3. B4bit Pay sends the customer an email with a link to the payment.
4. The customer pays on the B4bit Pay gateway.
5. Once the payment is confirmed, B4bit Pay marks the Shopify order as paid automatically.
6. The customer returns to the store.

Caution

Mandatory requirement: the customer must provide a valid email address in their purchase data, since the flow relies on email to deliver the payment link.

Support

support@b4bit.com.