MacellanMacellan SuperApp
Ödemeİade

Direct Refund

  • Direct Refund servisi, entegratör firmanın kullanıcı tarafından oluşturulan iade isteği olmaksızın harcama işlemini iade etmek için kullanılır.

Ü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ı, ödeme tutarı price + point ile eşleşmelidir
POST
/integration/payment/refund/direct

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

amount*number

İade Edilmek İstenen Tutar

Formatfloat
Multiple Of0.01
Range1 <= value <= 99999
order_id*integer

Harcama İşlemi Unique Sipariş ID

Formatint64
comment?string

Şirket Notu

product_list?

Ürün listesi

{
  "amount": 1.23,
  "order_id": 1131347753,
  "comment": "Test",
  "product_list": [
    {
      "item_id": 1,
      "name": "Ayran",
      "category_name": "İçecekler",
      "price": 20,
      "quantity": 2,
      "total_price": 40
    }
  ]
}

Response Body

application/json

application/json

application/json

curl -X POST "https://api.altpay.dev/integration/payment/refund/direct" \  -H "Content-Type: application/json" \  -d '{    "amount": 1.23,    "order_id": 1131347753  }'
{
  "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"
    },
    "refunds": [
      {
        "id": 1,
        "type": "full_refund",
        "amount": 1,
        "point": 1,
        "final_total": 2,
        "created_at": "2025-01-15T09:00:00+03:00",
        "updated_at": "2025-01-15T09:00:00+03:00"
      }
    ]
  }
}
{
  "message": "Unauthenticated"
}
{
  "message": "İşlemi yapmak için yetkili değilsiniz."
}

Bu sayfada