Fees

This endpoint is used to retrieve the fees associated with a bill payment request. It requires the service ID and the Balad reference number as input parameters.

Request Params

SI No	Parameter	Type	Mandatory	Remarks
1	service_id	String	Y	Unique service ID
2	balad_reference_number	String	Y	The reference number generated for the inquiry.

Response Params

Params	Remarks
account_number	The account number associated with the transaction
fees_egp	The fees amount in Egyptian pounds
total_amount_egp	The total amount in Egyptian pounds
amount_egp	The amount in Egyptian pounds
balad_reference_number	The reference number identifying the transaction
foreign_amount	The amount in foreign currency
foreign_currency_code	The currency code of the foreign currency
partner_foreign_fees	The fees applied by the partner in foreign currency
total_foreign_amount	The total amount in foreign currency
display_message	The display message for the transaction
is_fees_calculated	Indicates if the fees are calculated

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Example

{
    "service_id":1001,
    "parameters":[
        {
            "key":"balad_reference_number",
            "value":"XXXX"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Fees

application/json

Bodyapplication/json

Example

{
    "data": [
        {
            "key": "balad_reference_number",
            "value": "XXX"
        },
        {
            "key": "amount_egp",
            "value": "XXX"
        },
        {
            "key": "account_number",
            "value": "XXXXXXXXXX"
        },
        {
            "key": "display_message",
            "value": "Home Internet 20GB"
        },
        {
            "key": "total_amount_egp",
            "value": "XX"
        },
        {
            "key": "foreign_amount",
            "value": "XX"
        },
        {
            "key": "total_foreign_amount",
            "value": "XX"
        },
        {
            "key": "foreign_currency_code",
            "value": "USD"
        },
        {
            "key": "fees_egp",
            "value": "XX"
        }
    ],
    "errors": null
}