Paylov API

Appearance

Card Monitoring ​

To get Card Monitoring, merchants must follow these steps:

  1. Create a Card in the Paylov System. (Docs available here)
  2. Send a request to the getCardHistory service.

Endpoint details ​

Method: GET
URL: BASE_URL/merchant/getCardHistory/
Headers:

plaintext
  api-key: "kfggfgf.given_api_key_by_paylov"

Query:

Querysample_dataTypeRequiredDescription
cardId9f877739-bc25-4f0f-a13f-ec485fd04250stringYescardId created in Paylov system
from_date2024-04-18stringNostarting date
to_date2024-06-15stringNoending date

Request example ​

plaintext
BASE_URL/merchant/getCardHistory/?cardId=9f877739-bc25-4f0f-a13f-ec485fd04250

Example request with from_date and to_date ​

plaintext
 BASE_URL/merchant/getCardHistory/?cardId=9f877739-bc25-4f0f-a13f-ec485fd04250&from_date=2024-12-01&to_date=2025-03-01

Response Example ​

The response structure for HUMO and UZCARD is the same but differs in fields

Response body ​

json
{
  "result": {
    "processing": "string",
    "data": [
      {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    ]
  }
}

HUMO Card Response ​

json
{
    "result": {
        "processing": "humo",
        "data": [
            {
                "CARD_ACCT": "34011760001111111",
                "ACCOUNT_NO": "211111111",
                "CL_ACCT_KEY": "212221221",
                "CLIENT": "01111111",
                "CARD": "9860000000000000",
                "EXP_DATE": null,
                "TRAN_TYPE": "110",
                "TRAN_CCY": "UZS",
                "TRAN_AMT": "555000000",
                "CCY_EXP": "2",
                "TRAN_DATE_TIME": "2024-03-28T00:00:00",
                "REC_DATE": "2024-03-28T00:00:00",
                "POST_DATE": "2024-03-28T00:00:00",
                "ACCNT_CCY": "UZS",
                "AMOUNT_NET": "855000000",
                "ACQREF_NR": null,
                "APR_CODE": "000000",
                "APR_SCR": null,
                "STAN": null,
                "TERM_ID": null,
                "MERCHANT": null,
                "POINT_CODE": null,
                "MCC_CODE": null,
                "ABVR_NAME": null,
                "CITY": null,
                "COUNTRY": null,
                "DEAL_DESC": "#ASBT79311111#",
                "COUNTERPARTY": null,
                "INTERNAL_NO": "3840111111",
                "FLD_104": null,
                "BANK_C": "34",
                "GROUPC": "01",
                "CTIME": "2024-03-28T16:29:50",
                "TR_CODE": null,
                "TR_FEE": null,
                "TR_CODE2": null,
                "TR_FEE2": null,
                "LOCKING_FLAG": null,
                "ADD_INFO": "API_ONLINE_PAYMENT",
                "REF_NUMBER": null
            }
              ]
         }
    }

UZCARD Response ​

json
{
    "result": {
        "processing": "uzcard",
        "data": [
            {
                "utrnno": 21588011111,
                "transType": "785",
                "hpan": "860003******3511",
                "utime": 143554,
                "udate": 20240701,
                "bankDate": null,
                "reqamt": 3500000,
                "resp": -1,
                "reversal": false,
                "orgdev": 997412,
                "merchant": "901335111",
                "terminal": "92000111",
                "merchantName": "TOSHKENT SH., ASAKA AT BANKINING BOSH",
                "street": "Toshkent shakhar Nukus kuchasi ",
                "city": "Toshkent shakhar",
                "isCredit": true,
                "credit": true,
                "mcc": 5999,
                "currency": 860,
                "actamt": 3500000,
                "acctbal": 8479000,
                "conamt": 3500000
            }
              ]
         }
 }