Skip to content

Get Single Card

Endpoint details

Method: GET
URL: BASE_URL/merchant/userCard/getCard/{cardId}/
Header:

plaintext
api-key: kfggfgf.given_api_key_by_paylov
PathTypeRequired
cardIdstringYes

Success response

json
{
  "result": {
    "card": {
      "userId": "707",
      "cardId": "66634c5b-e5d9-4b2c-b95c-fc14da331830",
      "owner": "BOTIROV TEMURBEK",
      "cardName": "string",
      "number": "986034******8885",
      "balance": 24032775200,
      "expireDate": "2909",
      "bankId": "32",
      "vendor": "Humo",
      "processing": "Humo",
      "status": {
        "result": {
          "is_active": true,
          "status_message": "active",
          "sms_info": true
        }
      }
    }
  }
}

balance in tiyn: 100 = 1 Sum

Error response

json
{
  "error": {
    "code": "card_not_found_in_processing_center",
    "message": "card_not_found"
  }
}

Error codes of the method

CodeMessageDescription
card_not_found_in_processing_centercard_not_found
card_is_blocked_in_processing_center
card_is_blockedcard is inactive or blocked in processing center (in Uzcard/Humo)
balance_refresh_errorbalance_refresh_error
card_not_foundcard_not_foundcard not found in Paylov system

Success response when card status not active

json
{
  "result": {
    "card": {
      "userId": "32",
      "cardId": "1a11a111-b6c1-43c2-b1ae-ee3f7b51231f",
      "owner": "SURNAME NAME",
      "cardName": "",
      "number": "561468******1311",
      "balance": 150000,
      "expireDate": "2505",
      "bankId": "13",
      "vendor": "MIR",
      "processing": "Uzcard",
      "status": {
        "result": {
          "is_active": false,
          "status_message": "stolen_card_capture",
          "sms_info": true
        }
      }
    }
  }
}

Card status messages

💡 Note: The status_message = active when is_active = true.

active
call_issuer
warm_card do_not_honor
honor_with_id
not_permitted
lost_card_capture
stolen_card_capture
call_security_capture
invalid_card_capture
pick_up_card_special_condition
call_acquirer_security
temporary_blocked_by_user
pin_attempts_exceeded
forced_pin_change
credit_debts
unknown
pin_activation
instant_card_personification_waiting
fraud_prevention
permanent_blocked_by_client
temporary_blocked_by_client
decline_restricted_card
decline_card_not_effective
pick_up_restricted_card
pick_up_special_conditions
pick_up_lost_card
pick_up_stolen_card
decline_card_not_active_at_bank_will
decline_card_not_active_at_cardholder_will