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

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

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

نام	نوع	الزام	توضیحات
merchant_id	String	بله	كد 36 كاراكتري اختصاصي پذيرنده
amount	Integer	بله	مبلغ تراكنش به (ریال)
description	String	بله	توضیحات مربوط به تراکنش
callback_url	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": "پرداخت تست ۱۱۰",
  "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": "افزایش اعتبار کاربر شماره ۱۱۳۴۶۲۹",
  "metadata": {"mobile": "09121234567","email": "info.test@gmail.com"}
}'

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

قبلی

تسویه اشتراکی

بعدی

ریورس تراکنش