# همکاری در فروش

با استفاده از پارامتر referrer_id می‌توانید از تراکنش‌های انجام‌شده توسط زیرمجموعه‌های خود سهم دریافت کنید. برای شروع کافی است یک حساب کاربری زرین‌پال داشته باشید و لینک همکاری خود را از پنل کاربری (opens new window) دریافت کنید.

برای آشنایی بیشتر با جزئیات برنامه همکاری در فروش، به صفحه رسمی همکاری در فروش زرین‌پال (opens new window) مراجعه کنید.

نام	نوع	الزام	توضیحات
merchant_id	String	بله	كد ۳۶ كاراكتری اختصاصی پذیرنده
currency	String	خیر	تعیین واحد پولی
amount	Integer	بله	مبلغ تراكنش
description	String	بله	توضیحات مربوط به تراکنش
callback_url	String	بله	صفحه بازگشت پذیرنده، پس از انجام عمل پرداخت
referrer_id	String	خیر	کد معرف
metadata	Array
mobile	String	خیر	شماره تماس خریدار
email	String	خیر	ایمیل خریدار

# خطاها

هنگام استفاده از پارامتر referrer_id ممکن است خطاهایی رخ دهد که معمولاً به دلیل معتبر نبودن کد معرف، اشتباه در ارسال داده، یا وضعیت فعلی ترمینال ایجاد می‌شوند.

در برخی موارد این خطاها به‌صورت مستقیم بازگردانده نمی‌شوند و تنها باعث می‌شوند مقدار referrer_id نادیده گرفته شده و در تراکنش ذخیره نشود. در جدول زیر، جزئیات هر حالت و رفتار سیستم مشخص شده است.

کد	توضیح خطا	نحوه‌ی برخورد سیستم
429	قالب کد معرف معتبر نیست	درخواست رد می‌شود و خطا به‌صورت مستقیم برگردانده می‌شود.
—	خطای رمزگشایی شناسه (Invalid decoding)	در این حالت مقدار referrer_id پردازش نمی‌شود و در تراکنش ذخیره نخواهد شد.
—	کاربر معرف یافت نشد	در این حالت مقدار referrer_id پردازش نمی‌شود و در تراکنش ذخیره نخواهد شد.
—	ترمینال متعلق به معرف است	در این حالت مقدار referrer_id پردازش نمی‌شود و در تراکنش ذخیره نخواهد شد.
—	ترمینال از قبل دارای معرف است	در این حالت مقدار referrer_id پردازش نمی‌شود و در تراکنش ذخیره نخواهد شد.

نکته

تمامی داده‌های برگشتی از زرین‌پال به صورت json می‌باشد.

https://payment.zarinpal.com/pg/v4/payment/request.json

نمونه درخواست

درخواست
پاسخ

curl -X POST \
  https://payment.zarinpal.com/pg/v4/payment/request.json \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -d '{
  "merchant_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "currency": "IRT",
  "amount": 10000,
  "callback_url": "http://example.com/verify",
  "description": "افزایش اعتبار کاربر شماره ۱۱۳۴۶۲۹",
  "referrer_id": "xxxx",
  "metadata": {"mobile": "09121234567","email": "info.test@gmail.com"}
}'

تمام مراحل دیگر مانند بخش راهنمای اتصال می باشد .