Overview

Hapana Core offers the ability to customize fee structures when using Ezypay by leveraging the accountingCode during invoice creation. This gives businesses more control over transaction fees, allows for flexible pricing strategies. 

By configuring these settings, businesses can tailor their client billing experience, improve reconciliation accuracy, and ensure first-time buyers of introductory offers are not charged unnecessary fees.

Prerequisites

• Use of Ezypay as the payment gateway
• Coordination with your Account Manager to enable configuration settings

Impact

This feature is limited to 2 fee structures that must be defined with Ezypay prior to enabling in Hapana.
The feature will trigger one set of fees for Introductory Offers and another for all other transactions.

Step-by-Step Instructions

Step 1: Contact Your Account Manager

Reach out to your Hapana Account Manager and request to enable accountingCode usage.

Step 2: Enable Configuration

Upon your request, the Hapana team will enable the Configuration. This setting is disabled by default and must be manually turned on by Hapana support team.

Step 3: Understand Invoice Creation Behavior

When enabled, invoice requests to Ezypay will now automatically:

• Include the accountingCode field to control specific fee behaviors.

Step 4: Recognize How Introductory Offers Are Handled

If a client purchases an Intro Offer, Hapana will automatically append the accountingCode "HapEzyNoFPFees" to the invoice creation API.

This ensures:

• No failed payment fees are applied to first-time buyers of intro offers.
• A smoother onboarding and billing experience for new clients.

Tip: This functionality is limited to transactions involving Introductory Offers only at this time.

Expected Outcome

Once configured, your Ezypay transactions will:

• Apply custom fee rules using the accountingCode.
• Automatically exempt intro offer clients from failed payment fees.

This improves client satisfaction, billing accuracy, and administrative control.

FAQs

Q: Does this apply to Stripe or other gateways?

No. This feature is specific to Ezypay and does not impact transactions processed through Stripe, Midtrans, or other gateways.

Q: Can I manually set accountingCodes on a per-transaction basis?

No. The accountingCode is automatically applied by the system based on the type of transaction, such as sales involving Intro Offers.

Q: Will enabling accountingCode affect existing invoices?

No. It will only affect invoices created after the feature is enabled.