GetBillerList

POST https://move-uat.goverapay.com/customer/billers/list

Headers

Name	Type	Description
UserId	ANS	Generated during User Registration
Authorization	ANS	Generated during User verify

Request Body

Name	Type	Description
UUID	ANS (36)	Unique for each transaction
transType	INT (2)	value: "15"

200: OK

Sample Data:

Request header

userId : 2

Authorization : Bearer {{Token}}

Request

{
    "UUID": "1e056384-625a-43ba-9876-6ddd7d9a5d51",
    "transType": "15"
}

Response

{
  "UUID": "764f55cc-c93c-437a-ad7b-69831ce9909e",
  "transType": "15",
  "payees": [
    {
      "name": "Zain Top Up",
      "payeeId": "0010010001",
      "category": "Utility",
      "paymentInfo": [
        {
          "name": "Phone Number",
          "tag": "MPHONE",
          "pattern": "^0\\d{9}$"
        }
      ],
      "logoUrl": "0010010001.jpg"
    },
    {
      "name": "MTN Top Up",
      "payeeId": "0010010003",
      "category": "Utility",
      "paymentInfo": [
        {
          "name": "Phone Number",
          "tag": "MPHONE",
          "pattern": "^0\\d{9}$"
        }
      ],
      "logoUrl": "0010010003.jpg"
    },
    {
      "name": "E-Invoice",
      "payeeId": "0055555555",
      "category": "Utility",
      "paymentInfo": [
        {
          "name": "Reference Number",
          "tag": "customerBillerRef",
          "pattern": "^[0-9A-Za-z_-]{1,15}$"
        }
      ],
      "logoUrl": "0055555555.jpg"
    },
    {
      "name": "Zain Bill payment",
      "payeeId": "0010010002",
      "category": "Utility",
      "paymentInfo": [
        {
          "name": "Phone Number",
          "tag": "MPHONE",
          "pattern": "^0\\d{9}$"
        }
      ],
      "logoUrl": "0010010002.jpg"
    },
    {
      "name": "Sudani Top Up",
      "payeeId": "0010010005",
      "category": "Telecom",
      "paymentInfo": [
        {
          "name": "Phone Number",
          "tag": "MPHONE",
          "pattern": "^0\\d{9}$"
        }
      ],
      "logoUrl": "0010010005.jpg"
    },
    {
      "name": "Sudani Bill payment",
      "payeeId": "0010010006",
      "category": "Utility",
      "paymentInfo": [
        {
          "name": "Phone Number",
          "tag": "MPHONE",
          "pattern": "^0\\d{9}$"
        }
      ],
      "logoUrl": "0010010006.jpg"
    },
    {
      "name": "Sudani Bill payment",
      "payeeId": "0010010006",
      "category": "Utility",
      "paymentInfo": [
        {
          "name": "Phone Number",
          "tag": "MPHONE",
          "pattern": "^0\\d{9}$"
        }
      ],
      "logoUrl": "0010010006.jpg"
    },
    {
      "name": "NEC",
      "payeeId": "0010020001",
      "category": "Government",
      "paymentInfo": [
        {
          "name": "Meter Number",
          "tag": "METER",
          "pattern": "^[0-9]{1,9}$"
        }
      ],
      "logoUrl": "0010020001.jpg"
    },
    {
      "name": "Higher Education",
      "payeeId": "0010030002",
      "category": "Government",
      "paymentInfo": [
        {
          "name": "Student Seat Number",
          "tag": "SETNUMBER",
          "pattern": "^[0-9]{1,15}$"
        },
        {
          "name": "Student Course Id",
          "tag": "STUDCOURSEID",
          "pattern": "^[1|2|3|4|5|6|7]$",
          "list": "Academic,Agricultural,commercial,Industrial,Womanly,Ahlia,Readings"
        },
        {
          "name": "Student Form Kind",
          "tag": "STUDFORMKIND",
          "pattern": "^[1|2|3|4|5|6|7|8|9]$",
          "list": "General admission-first round,Special admission,Sons of higher education staff,General admission-second round,Special admission-vacant seats,Private institutions direct admission,Diploma in public institutions"
        }
      ],
      "logoUrl": "0010030002.jpg"
    }
  ],
  "responseMessage": "EBS_APPROVE",
  "responseCode": "0"