• English
  • Query merchant balance

    Request Path

    /api/v2/merchant/manage/account/queryBalance 

    Parameter List

    NameTypeLengthRequiredDescription
    merchantIdString32yesMerchant number

    Response Value

    NameTypeLengthRequiredDescription
    availableBalanceLong20yesMerchant available balance
    frozenBalanceLong20yesMerchant frozen balance
    currentBlanceLong20yesTotal Merchant balance = merchant balance + merchant frozen balance
    unSettleBalanceLong20yesUnsettle balance Merchant balance to be settled

    Error Code

    Error Code

    Postman Example

    request

    curl --location 'https://open-gw-sandbox.palmpay-inc.com/api/v2/merchant/manage/account/queryBalance' \
    --header 'Accept: application/json, text/plain, */*' \
    --header 'CountryCode: NG' \
    --header 'Authorization: Bearer 10241024' \
    --header 'Signature: D11A3E8CB478C0B0F40276DDA5AFD898' \
    --header 'Content-Type: application/json' \
    --data '{
        "requestTime":1662171389940,
        "version":"V1.1",
        "nonceStr":"IBJGAeTa4ZJQv4Z2qufomVo9eI1YnJ9Y",
        "merchantId":"24911478"
    }'

    response

    {
      "respCode":"00000000",
      "respMsg":"success",
      "data":{
        "availableBalance":50000,
        "frozenBalance":50000,
        "currentBalance":50000,
        "unSettleBalance":50000
      }
    }