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