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

# تسهیم درآمد

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

برای استفاده از این سرویس ابتدا از طریق ارسال تیکت درخواست فعال‌سازی آن را ثبت نمایید و پس از فعال‌سازی به کمک روش توضیح داده شده یا از طریق API از آن استفاده کنید.

لطفا در نظر داشته باشید: حداقل مبلغ برای تسهیم فردایی، ۱۰۰ هزار ریال است.

تسیهم فردایی، از ساعت ۰۵:۰۰ الی ۲۳:۰۰ قابل استفاده است.

کارمزد تسهیم به مبلغ خالص درخواستی اضافه خواهد شد.

# شناسه حساب بانکی

برای استفاده از این سرویس، در مرحله اول نیاز به دریافت اطلاعات شماره حساب بانکی پنل کاربری خود دارید. برای مشاهده این اطلاعات می‌توانید از کوئری زیر استفاده کنید:

query{
  BankAccounts(limit: 200) {
    id
    iban
    holder_name
  }
}

در پاسخ به این درخواست، پاسخی به این شکل دریافت می‌شود:

{
  "data": {
    "BankAccounts": [
      {
        "id": "367527",
        "iban": "IR470620000000303091989009",
        "holder_name": "خلیل یوسفی"
      },
      {
        "id": "297008",
        "iban": "IR500170000000353309608005",
        "holder_name": "امین  محمد رنجبر"
      },
      {
        "id": "290406",
        "iban": "IR760570028080010489217101",
        "holder_name": "وحيد داوري"
      },
      {
        "id": "284481",
        "iban": "IR490130100000000278238518",
        "holder_name": "آرمین زاهدی"
      }
    ]
  }
}

# شناسه درگاه پرداخت (ترمینال ایدی)

در مرحله دوم نیاز به دریافت شناسه درگاه پرداخت خود دارید که برای مشاهده آن می‌توانید از کوئری زیر استفاده کنید:

query terminals {
  Terminals {
    id
    domain
  }
}

در پاسخ به این درخواست، پاسخی به این شکل دریافت می‌شود:

{
  "data": {
    "Terminals": [
      {
        "id": "221217",
        "domain": "doosoo.ir"
      },
      {
        "id": "1185",
        "domain": "u-b.ir"
      },
      {
        "id": "238",
        "domain": "golroz.com"
      }
    ]
  }
}

# ساخت تسهیم درآمد

پس از به دست آوردن شماره حساب بانکی ، می‌توانید با استفاده از پارامترهای زیر یک درخواست برای ساخت تسهیم درآمد ایجاد کنید:

  • terminal_id شناسه درگاهی (ترمینال ایدی) که این قابلیت برای آن فعال است. (اجباری)

  • amount مبلغ به ریال(اجباری)

  • bank_account_id شناسه حساب بانکی که در پنل کاربری زرین‌پال خود ثبت کرده‌اید. (اجباری)

  • description توضیحات

  • reconciliation_parts برای این مورد باید MULTI وارد شود.

mutation PayoutAdd($terminal_id: ID!, $bank_account_id: ID!, $amount: BigInteger!, $description: String, $reconciliation_parts: ReconciliationPartsEnum) {
  resource: PayoutAdd(terminal_id: $terminal_id, bank_account_id: $bank_account_id, amount: $amount, description: $description, reconciliation_parts: $reconciliation_parts) {
    reconciliation_parts
    id
    url_code
    description
    status
    amount
    percent
    created_at
    updated_at
  }
}

Query Variables

{
  "terminal_id": "238",
  "bank_account_id": "249773",
  "amount": "100000",
  "description": "تست سرویس",
  "reconciliation_parts": "MULTI"
}

در پاسخ به این درخواست، پاسخی به این شکل دریافت می‌شود:

{
  "data": {
    "resource": {
      "reconciliation_parts": "MULTI",
      "id": "64340",
      "url_code": "81mmmW",
      "description": "تست سرویس",
      "status": "ACTIVE",
      "amount": 100000,
      "percent": 0,
      "created_at": "2022-12-05T19:07:04+03:30",
      "updated_at": "2022-12-05T19:07:04+03:30"
    }
  }
}