How to integrate Alif Pay and JazzCash with Microsoft Store Commerce App?

Step-by-step implementation in Dynamics 365 MPOS

Integrating Alif Pay and JazzCash into Dynamics 365 MPOS involves extending the existing payment workflow to support QR code-based transactions. The implementation includes frontend customization for QR display, backend service development for API communication, and operational logic for verifying and completing payments. Further reading: How can MPOS in Dynamics 365 be customized for payment extension scenarios? Follow the steps below to set up the implementation:

Step 1: Open the project in the scale unit

Begin by opening the project in the Commerce Scale Unit. This will be the backend layer where all service logic and controller classes will be implemented.

Step 2: Set up folder structure

Create a new folder dedicated to payment integration inside the Extend folder, such as CFZ_JazzCash. Divide your code into three main components:

• • Dialog layer: This includes the HTML and module files used to create the dialog box for QR display.

• • Operations layer: This will house logic to handle dialog actions.

• • Backend layer (CRT): For controllers, services, and message contracts.

Step 3: Create the dialog box

DialogSample HTML

DialogSampleModule

Step 4: Implement the operations handler

In the second folder, named Operations, write a handler class responsible for:

• • Controlling the dialog interface

• • Refreshing the QR code

• • Checking the payment status via the external gateway

  Refer to the example image provided to structure your class effectively.

Step 5: Add the PreAddTenderLine trigger

Next, integrate the PreAddTenderLine trigger into the Dynamics 365 MPOS flow. This trigger will invoke the payment dialog when a QR-based method is selected at checkout.

Step 6: Backend development – Commerce runtime

Switch to the backend in the Commerce Runtime (CRT) and follow these steps:

• • Update the customer controller: Add code to the customer controller that facilitates the interaction between the MPOS and the payment gateway.

Step 7: Create message contracts

Inside the Message Request folder, define your:

• • Request class: To send payment data and request the QR code.

• • Response class: To receive and interpret responses from the payment gateway.

  These classes are essential for communication between the frontend and the backend.

This is an example image of the response class:

Step 8: Develop the API service class

Now, implement a service class to handle external API calls. This service should:

• • Call the third-party API (JazzCash or Alif Pay) to get a QR code in Base64 format.

• • Convert the Base64 string into an image displayed in the dialog.

  Maintain logs for each API request and response, as shown in the attached image references.

Step 9: Implement logging

Finally, make sure all payment-related activities are logged properly. Maintain logs for:

• • Transaction requests

• • API responses

• • Payment status

  These logs should be stored in the Retail MPOS and Headquarters (HQ) systems to ensure full visibility and traceability.

Conclusion

Integrating third-party payment solutions like Alif Pay and JazzCash into the Microsoft Dynamics 365 Store Commerce App (MPOS) marks a significant step toward modernizing retail transactions. By enabling secure, QR code-based payments directly within the POS workflow, this solution enhances customers' checkout experience and streamlines operations for frontline staff. This implementation provides a scalable foundation for adopting mobile-first payment experiences with real-time API interactions, robust logging, and backend service integration. As retailers prioritize speed, security, and convenience, such integrations will play a critical role in driving customer satisfaction and business efficiency. If you want to implement or scale digital payment integrations within your Dynamics 365 ecosystem, contact Confiz at marketing@confiz.com. Our team of experts can help you design and deploy intelligent, secure, and scalable commerce solutions tailored to your business needs.