# پرداخت با کارت مشخص

با استفاده از این سرویس، خریدار تنها با کارتی که قبلا توسط شما احراز شده و مورد تایید شما است پرداخت را انجام می‌دهد. برای ناموفق بودن تراکنش در صورت استفاده از کارت بانکی دیگر، باید در قسمت metadata ، card_pan را اضافه کنید و در آن مقدار شماره کارت مورد نظر را وارد نمایید.

اطلاعات ارسالی

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

مقادیری که توسط متد verify برگشت داده می‌شود به شرح زیر است:

نام	نوع	توضیحات
code	Integer	عددی که نشان دهنده موفق بودن یا عدم موفق بودن پرداخت میباشد.
ref_id	Integer	در صورتی که پرداخت موفق باشد؛ شماره تراکنش پرداخت انجام شده را بر میگرداند.
card_pan	String	شماره کارت به صورت Mask
card_hash	String	هش کارت به صورت SHA256
fee_type	String	پرداخت کننده کارمزد که در پنل میان کاربر و یا خود پذیرنده قابل انتخاب است
fee	Integer	کارمزد

مثال:

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

درخواست
پاسخ

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",
  "amount": 10000,
  "callback_url": "http://yoursite.com/verify",
  "description": "پرداخت تست ۱۱۰",
  "referrer_id": "xxxx",
  "metadata": {"mobile": "09121234567","email": "info.test@gmail.com", "card_pan":"5022291912345678",}
}'

نمونه کد وریفای

درخواست
پاسخ

curl -X POST \
  https://payment.zarinpal.com/pg/v4/payment/verify.json \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -d '{
  "merchant_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "amount": 10000,
  "authority": "A0000000000000000000000000000wwOGYpd"
}'

# ذخیره کارت در درگاه

در مرحله‌ای که کاربر قصد پرداخت اینترنتی برای یک کالا یا خدمات را دارد و به درگاه پرداخت متصل می‌شود، نیاز است تا اطلاعات کارت بانکی خود را وارد نماید که این اطلاعات شامل شماره‌ی ۱۶ رقمی، کد CVV2 و تاریخ انقضا (ماه / سال) درج شده روی کارت بانکی فرد است. پس از وارد کردن اطلاعات اصلی، نیاز است تا کد امنیتی که در همین صفحه به او نمایش داده می‌شود را نیز وارد نماید تا بتواند رمز پویا را از طریق پیامک بانکی دریافت کند و پرداخت خود را ثبتِ نهایی کند.

چنانچه پذیرنده، شخصا فرآیند ارسال پارامتر شماره همراه پرداخت کننده را هنگام کدنویسی پیاده‌سازی کند، در این مرحله پس از انتقال کاربر پرداخت‌کننده به درگاه پرداخت اینترنتی، شماره همراه کاربر، توسط زرین‌پال به بانک عامل فرستاده شده، سپس اطلاعات کارت بانکی مرتبط با آن شماره همراه ذخیره می‌شود و در پرداخت‌های بعدی با همان شماره موبایل، تاریخچه‌ی اطلاعات درج شده روی کارت، جهت انتخاب مجدد به کاربر نمایش داده می‌شود. سپس فرد می‌تواند با انتخاب کارت موردنظر خود، بدون کوچک‌ترین خطا و در کوتاه‌ترین زمان ممکن، از تمام اطلاعات کارت بانکی خود، تنها کد CVV2 را وارد نماید، بدون این‌که نیاز باشد شماره‌ی کامل کارت بانکی، ماه و سال انقضای کارت خود را مجددا وارد کند.

از مهم‌ترین ویژگی‌های این روش، افزایش سرعت پرداخت به واسطه‌ی هوشمندسازی مسیر پرداخت است ضمن این‌که کاربر تجربه‌ی خوشایندی از نحوه‌ی پرداخت آسان و سریع خواهد داشت که همین مساله فرد را به خرید مجدد نیز ترغیب خواهد کرد. به صورت کلی به کمک فرآیند هوشمندِ پیاده‌سازی شده در درگاه پرداخت اینترنتی زرین‌پال، بروز خطا هنگام وارد کردن شماره کارت یا سایر اطلاعات بانکی توسط فرد پرداخت‌کننده، کاهش یافته و ضریب پرداخت موفق به مقصد نهایی افزایش می‌یابد.

برای اجرای این مورد باید پارامتر موبایل را از خریدار دریافت کنید و در اطلاعات ارسالی به زرین‌پال ارسال نمایید.

به نوع داده ها و نام فیلد توجه کنید.

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

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

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",
  "amount": 10000,
  "callback_url": "http://yoursite.com/verify",
  "description": "افزایش اعتبار کاربر شماره ۱۱۳۴۶۲۹",
  "referrer_id": "xxxx",
  "metadata": {"mobile": "09121234567","email": "info.test@gmail.com"}
}'

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

قبلی

واحد پولی

بعدی

ریورس تراکنش