خانه درگاه پرداخت پرداخت مستقیم مستندات API مستندات SDK راهنمای استفاده افزونه‌ها

# استرداد وجه

به کمک سرویس استرداد وجه (ریفاند) زرین‌پال، در صورت تغییر یا لغو سفارش مشتریان، واریزی‌های اشتباه یا هرگونه الزامی جهت بازگرداندن وجه به خریدار، تمام مبلغ واریز شده یا حتی بخشی از آن را به صورت آنی یا در سیکل های پایا، خودکار به حساب آن‌ها واریز نمایید.

کالکشن پست من (opens new window)

# شماره تراکنش و مبلغ

برای استفاده از این سرویس، نیاز به اطلاعاتی شامل شماره تراکنش مورد نظر و مبلغ آن است که در قسمت تراکنش‌ها قابل مشاهده است.

# استرداد عادی یا آنی

برای استرداد عادی که مبلغ در سیکل پایای بعد به حساب خریدار باز میگردد :
فیلد method را در ثبت درخواست برابر با PAYA قرار دهید

برای استرداد آنی که مبلغ در همان لحظه به حساب خریدار برمیگردد :
فیلد method را در ثبت درخواست برابر با CARD قرار دهید

# ثبت درخواست

پس از به دست آوردن شماره تراکنش و مبلغ آن برای ثبت درخواست استرداد وجه از درخواست زیر استفاده کنید:

پارامتر های مورد نیاز

  • session_id شماره تراکنش

  • amount مبلغ ریال (حداقل مبلغ قابل استرداد ۲۰۰۰۰ ریال)

  • description توضیح علت استرداد وجه

  • method متد استرداد وجه

    • PAYA عادی (مبلغ در سیکل بعدی پایا واریز خواهد شد.)

    • CARD آنی (مبلغ آنی واریز می‌شود.)

  • reason دلیل استرداد

    • CUSTOMER_REQUEST درخواست خریدار

    • DUPLICATE_TRANSACTION تراکنش تکراری

    • SUSPICIOUS_TRANSACTION تراکنش مشکوک

    • OTHER سایر

شما می‌توانید در محیط اجرای GraphiQL (opens new window) پرس‌و‌جوهای فوق را تست کنید.





Query Variables برای استرداد عادی 
{
  "session_id": "385404123",
  "amount": 11000,
  "description": "تست سرویس",
  "method": "PAYA" // استرداد عادی
  "reason": "CUSTOMER_REQUEST"
}


mutation AddRefund(
  $session_id: ID!
  $amount: BigInteger!
  $description: String
  $method: InstantPayoutActionTypeEnum
  $reason: RefundReasonEnum
) {
  resource: AddRefund(
    session_id: $session_id
    amount: $amount
    description: $description
    method : $method
    reason: $reason
  ) {
    terminal_id
    id
    amount
    timeline {
      refund_amount
      refund_time
      refund_status
    }
  }
}

Query Variables برای استرداد آنی

{
  "session_id": "385404123",
  "amount": 11000,
  "description": "تست سرویس",
  "method": "CARD" // استرداد آنی
  "reason": "CUSTOMER_REQUEST"
}

# پاسخ دریافتی

در پاسخ درخواست استرداد وجه ثبت شده، از سمت زرین‌پال پاسخ روبرو شامل: شماره تراکنش، مبلغ، شماره ترمینال، تاریخچه پرداخت و بازگشت را دریافت می‌کنید.

  • id شماره تراکنش

  • amount مبلغ پرداخت شده به ریال

  • terminal اطلاعات ترمینال درگاه

  • timeline تاریخچه تراکنش

    • refund_amount مبلغ استرداد

    • refund_time تاریخ ثبت استرداد

    • refund_status وضعیت استرداد


{
  "data": {
    "resource": {
      "terminal_id": "1915487",
      "id": "386426364",
      "amount": 20000,
      "timeline": {
        "refund_amount": 20000,
        "refund_time": "2022-11-02T15:15:37+03:30",
        "refund_status": "PENDING"
      }
    }
  }
}