MacellanMacellan SuperApp
Temassız Kart

Bakiye Sorgulama

Kart bakiye sorgulama işlemi yapar.

Kart Numarası

Kart numarası iki farklı formattan biriyle gönderilebilir:

  • card_no: Hex formatında işlenmiş kart numarası (örn: '1234ABCD')
  • card_no_raw: İşlenmemiş numerik kart numarası (örn: 123456789)

Bu alanlardan sadece birinin gönderilmesi zorunludur. card_no_raw gönderildiğinde, sistem otomatik olarak kart numarasını little-endian hex formatına dönüştürür.

Little-Endian Dönüşümü

Little-endian dönüşümü, kart numarasını hex formatına çevirip byte'ları ters çevirme işlemidir. Örneğin:

Numerik: 123456789
Little-endian: 15CD5B07
POST
/integration/tap-card/balance-inquiry

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

card_no*string | null

Kart numarası (card_no_raw olmadığında zorunlu)

card_no_raw?integer | null

İşlenmemiş kart numarası (card_no olmadığında zorunlu)

{
  "card_no": "15CD5B07",
  "card_no_raw": 123456789
}

Response Body

application/json

application/json

application/json

curl -X POST "https://api.altpay.dev/integration/tap-card/balance-inquiry" \  -H "Content-Type: application/json" \  -d '{    "card_no": "15CD5B07"  }'
{
  "data": {
    "id": 0,
    "visibility": true,
    "balance": 0.1,
    "point": 0.1,
    "total_balance": 0.1,
    "held_balance": 0.1,
    "held_point": 0.1,
    "total_held": 0.1,
    "company_id": 0,
    "user": {
      "id": 0,
      "first_name": "string",
      "last_name": "string",
      "full_name": "string",
      "email": "string",
      "phone": "string"
    }
  }
}
{
  "message": "Unauthenticated"
}
{
  "message": "İşlemi yapmak için yetkili değilsiniz."
}

Bu sayfada