Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
44 lines (32 sloc) 2.6 KB

Drupal Commerce 2.x integration

The project can be found here on and therefore can be installed using composer from the packagist (no need to add the repo manually to your composer.json). The sources are available on github.


Module installation and configuration

Quick walkthrough screencast

Drupal Commerce

Quick walkthrough steps

Generate pairing code on BTCPay server

  1. BTCPay server: create and configure a store
  2. in store settings go to "Access Tokens"
  3. click on [Create a new token]
  4. Label: enter some label (eg. my store)
  5. Public key: this needs to be left empty
  6. Facade: "merchant"
  7. click on [Request pairing]
  8. on next screen choose your configured store in** Pair to** select dropdown and click on [approve]
  9. note down the displayed 7-digit code at the top status message, e.g. "d7afaXr"
    (you will need that code below on gateway configuration, see below)

Commerce BTCPay: Installation + configuration

  1. install module: composer require drupal/commerce_btcpay
  2. enable the module: drush en commerce_btcpay -y
  3. make sure you have configured private file system (needed to store encrypted public+private key)
  4. Commerce BTCPay configuration (Commerce -> Configuration -> Payment -> Payment gateways):
  5. add payment method "BTCPay"
    • Mode: Test or Live (you can configure both individually)
    • Test/Live server host: enter your URL without https:// prefix e.g. (note valid SSL certificate needed)
    • Test/Live Paring code: enter the 7-digit pairing code from BTCPay "Access tokens" page
    • Save
      You should see a message that the tokens were successfully created.