Overview

Businesses can now customise fee structures in Ezypay by leveraging the "accountingCode" in invoice requests. This update allows for greater control over transaction fees, ensuring that specific charges—such as failed payment fees for first-time buyers—can be exempted. Additionally, Hapana now includes an External Invoice ID in all payment requests to Ezypay, preventing duplicate invoice processing and simplifying reconciliation.
 

Key Benefits

1. Custom Fee Structures for Transactions

• Apply different fee settings using the "accountingCode", offering flexibility in pricing and promotions.

2. Prevent Duplicate Invoices

• The External Invoice ID ensures that duplicate invoices are not processed in Ezypay, maintaining transaction accuracy.

3. Improved Customer Experience

• First-time buyers of introductory offers will not be charged failed payment fees, promoting retention and satisfaction.

4. Seamless Admin Control

• Easily enable or disable the "accountingCode" feature through the Admin panel under Payment Gateway Configuration for Ezypay.
   

How It Works

Admin Configuration

If you would like to take advantage of this new feature, please reach out to your Account Manager to request that the Hapana team enables the "accountingCode" usage. This is done in Hapana's Backend - Admin > Brands > Location > Payment Gateway Configuration.

Invoice API Update

• Invoice creation requests to Ezypay now include:

  • accountingCode to control fee structures.

  • External Invoice ID to prevent duplicate invoice processing.

Ezypay API Integration

• Handles secondary fee structures based on the accountingCode field.

Things to Keep in Mind

• Ezypay Specific Feature – The accountingCode functionality applies only to Ezypay transactions and does not affect other payment processors like Stripe.

• Default Setting – The feature is OFF by default and must be manually enabled in Hapana's Backend Admin panel.

• ​​​​​​​Limited to Introductory Offers – If this feature is enabled, any sale that includes an Intro Offer will automatically add the parameter "HapEzyNoFPFees" to the Invoice Creation API with Ezypay. It is important to note that currently, this option only applies to transactions that include an Intro Offer, limiting its broader application.

This update enhances financial control, ensures accurate invoice reconciliation, and provides a smoother payment experience for your customers.