Displaying Customer Paid Fees

Is important to provide customer with the transparency on extra fees charged to them and Ezypay is ready to help on this. Integrators can retrieve customer paid fees using Ezypay API and include the information in your platform. Since the information is available through API, integrators can then decide how they want to display it to customer. Ezypay recommend it to be displayed during the customer creating their payment method because our fees usually differs by payment method. This way, customer can select the best payment method that suits them.

Understanding Ezypay fees API response

Following are the data return by customer paid fees API and its explanation:

ParametersDescription
pricingCodeCode of the type of fees :
a) failed_payment_fee
b) transaction_fee
c) load_fee
descriptionVerbal description on pricingCode
appliesToSpecify which payment method applicable to the fees. Contains an array for the multiple payment method. If array is empty, it applies to all payment method.
accountingCodeSpecify which accounting code applicable to the fees. If is null, applies to all transaction regardless of the transaction code.
chargingOptionSpecify how the fees is charged:
a) AMOUNT - fees are charged as a fix amount
b) PERCENTAGE - fees are charged as a percentage of the transaction amount
c) BOTH - fees are charged with a fix amount plus a percentage of the transaction amount
amountThe fix amount fees is charged
percentagePercentage of transaction amount is charged
{
  "data": [
    {
      "pricingCode": "failed_payment_fee",
      "description": "Failed Payment Fee",
      "appliesTo": [],
      "accountingCode": null,
      "chargingOption": "AMOUNT",
      "amount": 8.5,
      "percentage": 0
    },
    {
      "pricingCode": "transaction_fee",
      "description": "Card Fee",
      "appliesTo": [
        "MASTERCARD",
        "VISA"
      ],
      "accountingCode": null,
      "chargingOption": "BOTH",
      "amount": 0.5,
      "percentage": 0.37
    },
    {
      "pricingCode": "transaction_fee",
      "description": "Bank Fee",
      "appliesTo": [
        "BANK"
      ],
      "accountingCode": null,
      "chargingOption": "BOTH",
      "amount": 0.35,
      "percentage": 0.15
    },
    {
      "pricingCode": "load_fee",
      "description": "Load Fee",
      "appliesTo": [],
      "accountingCode": null,
      "chargingOption": "AMOUNT",
      "amount": 2,
      "percentage": 0
    }
  ],
  "paging": {
    "nextUrl": null,
    "nextCursor": 0,
    "limit": 4,
    "totalCount": 4
  }
}

Using above example, there are total 4 different components for the fees and can be read as follow:

  1. Failed payment fees for all payment methods - $8.50
  2. Transaction fee for Mastercard and Visa - $0.50 + 0.37% of transaction amount
  3. Transaction fee for bank direct debit - $0.35 + 0.15% of transaction amount
  4. Load fees for all payment methods - $2.00

🚧

Warning

The API does not return any merchant paid fees. All the fees that appears in the API should be display to customer as extra charges.

Examples on Showing the Fees