Direct Charge

Direct Charge servisi Macellan SuperApp kullanıcısı onayı, QR veya referans kodu olmadan harcama işlemi yapmak için kullanılır.
Bu servisi kullanmak için Direct Payment Api modülünün açık olması gerekir.

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 + point ile eşleşmelidir

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

wallet_id*integer

Harcama Yapılacak Cüzdan ID

Formatint64

price*number

Harcama İşlem Tutarı

Formatfloat

Multiple Of0.01

Range1 <= value <= 99999

point?number

Harcama Puan Tutarı

Default0

Formatint64

Multiple Of0.01

Range1 <= value <= 99999

gateway*PaymentGateway

Harcama Geçidi

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

apply_campaigns?boolean

Harcama sonucunda kullanıcının kampanyadan faydalanıp faydalanmayacağını belirtir.

Defaulttrue

{
  "wallet_id": 12,
  "price": 1,
  "point": 0,
  "gateway": "terminal",
  "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
    }
  ],
  "apply_campaigns": true
}

Response Body

`application/json`

curl -X POST "https://api.altpay.dev/integration/payment/direct-charge" \  -H "Content-Type: application/json" \  -d '{    "wallet_id": 12,    "price": 1,    "gateway": "terminal"  }'

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