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: 15CD5B07Authorization
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."
}