Collect

Collect servisi, harcama işlemi tutarının belirlenmesi için kullanılır.
Firma kullanıcının Macellan SuperApp mobil uygulamasından oluşturduğu QR kod veya 6 haneli referans koduyla birlikte harcama tutarını servise ileterek bu servisi kullanır.
Servis başarılı bir şekilde çağrıldıktan sonra kullanıcı harcama özet ve onay ekranına yönlendirilir.

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.

Ü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

Range0 <= value <= 100000

reference_code*integer

6 Haneli Harcama Referans Kodu

Formatint64

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,
  "reference_code": 123456,
  "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/collect" \  -H "Content-Type: application/json" \  -d '{    "price": 1.23,    "reference_code": 123456  }'

{
  "data": {
    "payment_id": 1,
    "wallet_id": 1,
    "user_id": 1,
    "user_mapping_id": "8b5ac43a-20ce-4987-a739-d8a7ee480eaa",
    "company_id": 1,
    "branch_id": 1,
    "cashier_id": 1,
    "reference_code": 123456,
    "order_id": 1305549790,
    "price": 1,
    "paid_price": 1,
    "price_show": "1,00",
    "paid_price_show": "1,00",
    "point": 1,
    "point_show": "0,00",
    "final_total": 1,
    "final_total_show": "1,00",
    "discounted_total_amount": 1,
    "discounted_total_amount_show": "1,00",
    "discount_point": 0,
    "discount_point_show": "0,00",
    "discount_percent": 0,
    "refund_amount": 0,
    "status": "approved",
    "status_translate": "Onaylandı",
    "gateway": "terminal",
    "is_shared_wallet": true,
    "wallet_share_id": 0,
    "user_fillable_point": true,
    "wallet_share": {
      "description": "string"
    }
  }
}

{
  "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`