Billplz

Simplify online payments for Malaysian customers via Billplz

Billplz payment provider for Medusa commerce

Demo Link

Demo page - With NextJS starter

NPM - Billplz payment hackathon

About

Participants

GitHub Discord Twitter @ibnumalik ibnumalik#3920 @ibnumalikmy

Description

A Medusa plugin to extend its payment ecosystem using Billplz - a fair payment platform.

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

During development it’s highly recommended to set Copy to clipboardBILLPLZ_SANDBOX to true and ensure you have sandbox accounts set up in Billplz.

Then in Copy to clipboardmedusa-config.js, add Billplz Copy to clipboardplugins to the plugins array. This is some of the avaibale options that can be passed to the plugin:

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

TODO

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