MacellanMacellan SuperApp
WaasTemassız Kart

Kart İptali

  • Bu servis ile cüzdan kullanıcılarınıza tanımlı temassız kartları iptal edebilirsiniz.

  • Tek bir kart iptal etmek için de bu servis kullanılır, cards dizisine tek eleman göndermeniz yeterlidir.

  • Her istekte en fazla 50 kart gönderilebilir.

  • İptal edilemeyen kartlar fails listesinde sebebiyle birlikte döner. Listedeki diğer kartlar iptal edilmeye devam eder.

  • Aynı kart numarası bir istekte iki kez gönderilemez.

  • Kart iptali kullanıcının cüzdan bakiyesine dokunmaz. Kartın depozitosu varsa iade edildi olarak kapatılır, tutar cüzdana yüklenmez. İptal sebebi lost ise depozito iade edilmez.

İptal geri alınamaz. Aynı kart numarası daha sonra yeniden tanımlanabilir, ancak iptal edilen kayıt tekrar aktif edilemez.

POST
/waas/integration/tap-card/bulk/reset

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

cards*array<string>

İptal edilecek kart numaraları.

Items1 <= items <= 50
reason?string

İptal sebebi. Gönderilmezse refund kabul edilir.

DeğerAçıklama
refundKart iade edildi
lostKart kayıp
Default"refund"
Value in"refund" | "lost"
{
  "cards": [
    "1A2B3C4D",
    "5E6F7G8H"
  ],
  "reason": "refund"
}

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.altpay.dev/waas/integration/tap-card/bulk/reset" \  -H "Content-Type: application/json" \  -d '{    "cards": [      "1A2B3C4D",      "5E6F7G8H"    ]  }'
{
  "data": {
    "success_count": 1,
    "fails": [
      {
        "card_no": "5E6F7G8H",
        "message": "Kart bulunamadı."
      }
    ]
  }
}
{
  "message": "Unauthenticated"
}
{
  "message": "İşlemi yapmak için yetkili değilsiniz."
}
{
  "message": "Gönderdiğiniz Veriler Geçersiz",
  "errors": {
    "property": [
      "Hata açıklaması"
    ]
  }
}