MacellanMacellan SuperApp
WaasDirect Payment

Ödeme İade Servisi

  • Ödeme yapıldıktan sonra istenilen tutarda iade işlemi yapmak için kullanılır.

  • Ödeme Servisi isteğinden dönen order_id değeri ile işlem gerçekleştirebilir.

  • İade edilmek istenen tutar en fazla ödeme tutarı + ödeme puan tutarı olabilir.

Ü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
/waas/integration/payments/refunds/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

Ödeme İş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

application/json

curl -X POST "https://api.altpay.dev/waas/integration/payments/refunds/direct" \  -H "Content-Type: application/json" \  -d '{    "amount": 1.23,    "order_id": 1131347753  }'
{
  "data": {
    "order_id": "3279724498",
    "price": 1,
    "paid_price": 1,
    "point": 1,
    "final_total": 1,
    "refund_amount": 1,
    "refund_point": 1,
    "status": "approved",
    "status_translate": "Onaylandı",
    "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."
}
{
  "message": "Gönderdiğiniz Veriler Geçersiz",
  "errors": {
    "property": [
      "Hata açıklaması"
    ]
  }
}

Bu sayfada