Kart ile Ödeme

Bu endpoint kart numarası ile ödeme almak için kullanılır.

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

Ürün Listesi

product_list alanı opsiyoneldir ve satın alınan ürünlerin detaylarını bu alanda gönderebilirsiniz. Bu bilgiler raporlama ve analiz amaçlı kullanılır.

{
  "card_no": "15CD5B07",
  "card_no_raw": 123456789,
  "price": 40,
  "product_list": [
    {
      "item_id": 1,
      "name": "Ayran",
      "category_name": "İçecekler",
      "price": 20,
      "quantity": 2,
      "total_price": 40
    }
  ]
}

curl -X POST "https://api.altpay.dev/integration/tap-card/pay" \  -H "Content-Type: application/json" \  -d '{    "price": 40  }'

{
  "data": {
    "id": 1,
    "wallet_id": 1,
    "paid_price": 1.23,
    "point": 0,
    "final_total": 1.23,
    "refund_amount": 0,
    "transaction_code": "V4SBUQG3PMNLCR0",
    "reference_code": "123456",
    "order_id": "3279724498",
    "payment_time": "2019-08-24T14:15:22Z",
    "created_at": "2019-08-24T14:15:22Z",
    "status": "create",
    "status_translate": "Oluşturuldu"
  }
}

{
  "message": "Unauthenticated"
}

{
  "message": "İşlemi yapmak için yetkili değilsiniz."
}

{
  "message": "Gönderdiğiniz Veriler Geçersiz.",
  "errors": {
    "product_list": [
      "Ürün listesindeki fiyat hesaplamaları hatalı."
    ]
  }
}