Billplz payment provider for Medusa commerce

Demo Link

About

Participants

Description

Preview

Set up Project

Prerequisites

• Medusa Server
  • Tested on v1.4.1
• Create an account in Billplz and get API key by following the documentation

Installation

Install plugin package in Medusa backend

1
npm install medusa-payment-billplz

Configure the Billplz plugin

123456
BILLPLZ_COLLECTION_ID=<COLLECTION_ID>
BILLPLZ_API_KEY=<SECRET_KEY>
BILLPLZ_X_SIGNATURE_KEY=<XSIGNATURE_KEY>
STORE_URL=<STORE_URL>
BACKEND_URL=<BACKEND_URL>
BILLPLZ_SANDBOX=true

• Copy to clipboardCOLLECTION_ID can be retrieved in Billplz billing page.
• Copy to clipboardSECRET_KEY and Copy to clipboardBILLPLZ_X_SIGNATURE_KEY is available in your account settings.
• Copy to clipboardSTORE_URL is the store frontend url
• Copy to clipboardBACKEND_URL is medusa backend url

1234567891011121314
const plugins = [
  //other plugins...
  {
    resolve: `medusa-payment-billplz`,
    options: {
      api_key: BILLPLZ_API_KEY,
      x_signature_key: BILLPLZ_X_SIGNATURE_KEY,
      collection_id: BILLPLZ_COLLECTION_ID,
      production: !BILLPLZ_SANDBOX || false,
      store_url: STORE_URL,
      backend_url: BACKEND_URL
    }
  }
];

Resources

• Medusa - Create plugin
• Medusa - How to install plugin
• Billplz developer documentation
• Store example using this plugin

TODO

• Add instruction to use in NextJS storefront starter.
• Add library to provide components and hooks to use this plugins.