Search by

justbetter / magento2-module-checkoutviabol-graphql

justbetter

GraphQL support for the bol.checkout Magento 2 module, for headless frontends

Package info

github.com/justbetter/magento2-module-checkoutviabol-graphql

Type:magento2-module

pkg:composer/justbetter/magento2-module-checkoutviabol-graphql

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

0.1.0 2026-11-17 08:44 UTC

This package is not auto-updated.

Last update: 2026-11-18 07:23:22 UTC


README

Adds GraphQL support for the bol.checkout payment method (bol/magento2-module-checkoutviabol).

Features

  • cvb_redirect_url on CustomerOrder, which starts and confirms a bol.checkout session for a pending bol.checkout order and returns the url to redirect the customer to
  • Configurable redirects back to your frontend after paying or cancelling
  • startCvbCheckout and applyCvbSession mutations for the full bol.checkout flow, where guests fill in their details at bol

Installation

The bol.checkout module is installed from bol's own Composer repository, so make sure the bol repository is in the repositories section of your composer.json:

"repositories": {
  "bol": {
    "type": "composer",
    "url": "https://cvb.composer.bol.com/"
  }
}

Or add it with composer config repositories.bol composer https://cvb.composer.bol.com/.

  • composer require justbetter/magento2-module-checkoutviabol-graphql
  • bin/magento module:enable JustBetter_CheckoutViaBolGraphQl
  • bin/magento setup:upgrade
  • bin/magento setup:di:compile

Configuration

bol only receives paths (/cvb/...), the domain is configured on your bol merchant account. Point it to your frontend and make sure /cvb/* on that domain is passed to Magento.

Configure where the customer is redirected to in Stores > Configuration > Sales > Payment Methods > Bol.checkout GraphQL:

Field Description
Success path Path on your frontend after a successful payment, e.g. checkout/success. Guest orders get a token query parameter, which can be used with guestOrderByToken.
Cancel path Path on your frontend when the payment is cancelled or fails. Use this to reactivate the cart.
Checkout return path Path on your frontend to return to after filling in the details at bol, e.g. checkout/bol-return. Gets sid, nonce and session-result query parameters. Required for startCvbCheckout.
Cart path Path on your frontend when the customer cancels at bol before placing the order, e.g. cart.

These are paths, not urls, because bol only accepts paths. The customer always returns to the domain configured at bol. When left empty, the default bol.checkout urls are used.

Usage

Request cvb_redirect_url when placing the order and redirect the customer to it:

mutation {
  placeOrder(input: { cart_id: "..." }) {
    orderV2 {
      number
      cvb_redirect_url
    }
  }
}

cvb_redirect_url is only filled once per order, for orders paid with bol.checkout that are still pending payment.

Full checkout

Guests can also start at bol and fill in their details there. Start a session and redirect the customer to the returned url:

mutation {
  startCvbCheckout(cart_id: "...", action_identifier: 1)
}

Use action_identifier 1 when starting from the cart and 2 (default) when starting from the checkout.

bol redirects back to the checkout return path. When session-result is SUCCESS, apply the session to fill the email and addresses on the cart and select cvb as payment method. Only the session started with startCvbCheckout for this cart is accepted:

mutation {
  applyCvbSession(cart_id: "...", session_id: "<sid>", nonce: "<nonce>") {
    email
    shipping_addresses {
      available_shipping_methods {
        carrier_code
        method_code
      }
    }
    selected_payment_method {
      code
    }
  }
}

Let the customer choose a shipping method and place the order as usual. cvb_redirect_url then confirms the session the customer filled in, instead of starting a new one.