Payment Create

Create Servisi, harcama işlemlerini oluşturmak amacıyla kullanılır.
İşlem sonucunda dönen referans kodu, Macellan SuperApp kullanıcısına iletilir ve bu referans kodu ya da oluşturulan QR kodu kullanılarak işlem devam ettirilebilir.
QR kodun süresi 120 saniyedir.

Extra Bilgiler

external_id alanı opsiyoneldir. Genellikle ödemeye ait sipariş numarası gibi harici sistem ID'si burada gönderilir; işlemleri kolayca takip etmenize yardımcı olur.
Aynı kasa ve tutarla kısa süre içinde tekrar istek atıldığında mevcut QR döner. external_id farklı gönderilirse yeni bir QR üretilir.
Mevcut QR'ın tekrar kullanılabilmesi için external_id değerlerinin birebir eşleşmesi gerekir; isteklerden birinde external_id gönderilip diğerinde gönderilmediğinde de yeni bir QR üretilir.
Mevcut QR döndüğünde, istekle birlikte product_list gönderildiyse ürün listesi yeni gönderilen değerle güncellenir.

Ü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.

Ürün listesi gönderildiğinde:

Her ürün için price ve quantity alanları birlikte zorunludur
Her ürünün total_price değeri, price * quantity ile eşleşmelidir
Tüm ürünlerin total_price toplamı, harcama tutarı price ile eşleşmelidir

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

price*number

Harcama İşlem Tutarı

Formatfloat

Multiple Of0.01

Range1 <= value <= 99999

branch_code?string

Tek Bir Token İle Entegrasyon Sağlandığında Kullanılan Şube Kodu

external_id?string

Harici sistem ID değeri

product_list?

Ürün listesi

{
  "price": 1.23,
  "branch_code": "Test-123",
  "external_id": "EXT-12345",
  "product_list": [
    {
      "item_id": 1,
      "name": "Ayran",
      "category_name": "İçecekler",
      "price": 20,
      "quantity": 2,
      "total_price": 40
    }
  ]
}

Response Body

`application/json`

curl -X POST "https://api.altpay.dev/integration/payment/create" \  -H "Content-Type: application/json" \  -d '{    "price": 1.23  }'

{
  "data": {
    "hash": "hash",
    "payment_id": 1,
    "order_id": 1405321795,
    "reference_code": 123456,
    "expires_at": "2023-06-12T13:25:45.000000Z",
    "server_time": "2023-06-12T13:16:15.833622Z"
  }
}

{
  "message": "Unauthenticated"
}

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

Extra Bilgiler

Ürün Listesi

Authorization

Request Body

Response Body

200application/json

401application/json

403application/json

Bu sayfada

`application/json`

`application/json`

`application/json`