Retrieve Ezypay Customer Paid Fees

This page explains how integrators would be able to use Ezypay's API to identity all fees that will be customer paid.

📘

NOTE

Ezypay pay fees can either be charged to the customer or absorb by the merchant depending on what the merchants decide. This will be configured during Ezypay's merchant on-boarding process.

A detail explanation on what type of Ezypay fees are available can is explained in this link

All fees displayed from the response of this API will only include customer paid fees. Merchant paid fees will not be available using this API.

1. Call Ezypay's Fees Pricing API

[GET] https://api-global.ezypay.com/v2/billing/merchant/pricing/fees

The fees displayed will be dependent on the merchant ID that is provided.

Parameter Type

Description

pricingcode

Made up of one of the 3 fee type:

  1. transaction_fee (Either Bank or Credit Card transaction fees).

  2. load_fee (This are once off charged for first time transaction from a new customer details).

  3. failed_payment_fee (A penalty that incur for a payment that failed).

description

Details on what type of fees that is created.

appliesTo

What payment type that this fees will be applied too. The payment types are:

  1. BANK - This fee option only applies to Bank transactions.

  2. MASTERCARD - This fee option only applies to Mastercard transactions.

  3. VISA - This fee option only applies to VISA transactions.

  4. AMEX - This fee option only applies to VISA transactions.

    NOTE:
    If the applies parameter is "[]", this will mean that it is applicable to all.

accountingCode

Accounting Code can be use as a method to identity a unique payment option. For example there might be 2 fees option for a VISA card with different pricing.

If the Invoice was created with an accounting code that is tied to a pricing option, that pricing option will be used instead of the default.

chargingOption

This parameter accepts 3 options:

  1. Amount - A fixed amount is added on the invoice amount.

  2. Percentage - A percentage is added on the invoice amount.

  3. Both - A percentage and a fixed amount is added on the invoice amount.

amount & percentage

Depending on the "chargingOption" the values will be added to the respective parameter.

Below is a sample body on how the response from the Fee Pricing API looks like:

{
    "data": [
        {
            "pricingCode": "failed_payment_fee",
            "description": "Failed Payment Fee",
            "appliesTo": [],
            "accountingCode": null,
            "chargingOption": "AMOUNT",
            "amount": 12.00,
            "percentage": null
        },
        {
            "pricingCode": "transaction_fee",
            "description": "Transaction Fee",
            "appliesTo": [
                "VISA"
            ],
            "accountingCode": null,
            "chargingOption": "PERCENTAGE",
            "amount": null,
            "percentage": 1.49
        },
        {
            "pricingCode": "transaction_fee",
            "description": "Transaction Fee",
            "appliesTo": [
                "MASTERCARD"
            ],
            "accountingCode": null,
            "chargingOption": "PERCENTAGE",
            "amount": null,
            "percentage": 1.49
        },
        {
            "pricingCode": "transaction_fee",
            "description": "Transaction Fee",
            "appliesTo": [
                "BANK"
            ],
            "accountingCode": null,
            "chargingOption": "AMOUNT",
            "amount": 0.17,
            "percentage": null
        },
        {
            "pricingCode": "load_fee",
            "description": "Load Fee",
            "appliesTo": [],
            "accountingCode": null,
            "chargingOption": "AMOUNT",
            "amount": 2.20,
            "percentage": null
        }
    ],
    "paging": {
        "nextUrl": null,
        "nextCursor": 0,
        "limit": 5,
        "totalCount": 5
    }
}

Did this page help you?