Bill Status Check - IHELA OFFICIAL DOCS

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

bill_code

string

required

merchant_reference

string

required

pin_code

integer

required

Example

{
    "bill_code": "CODE-20230421-W9T6CYW",
    "merchant_reference": "752000",
    "pin_code": "1234"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://127.0.0.1:8081/api/v2/payments/bill-check/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bill_code": "CODE-20230421-W9T6CYW",
    "merchant_reference": "752000",
    "pin_code": "1234"
}'

Responses

🟢200OK

application/json

Body

response_code

string

required

response_data

object

required

bill_code

string

required

merchant_reference

string

required

payment_reference

null

required

status

string

required

Status can be :

"Initial" when initiated. This means the client has not yet paid

"Paid" when client has paid the bill

"Canceled" when the bill has been canceled

"Error" when there has been an error

response_message

string

required

success

boolean

required

Example

{
    "response_code": "00",
    "response_data": {
        "bill_code": "CODE-20230321-JQ4H26F",
        "merchant_reference": "752000",
        "payment_reference": null,
        "status": "Initial"
    },
    "response_message": "Done",
    "success": true
}