# میان‌پی (صفحه چک‌اوت)
برای ارسال اطلاعات سبد خرید در هنگام ایجاد تراکنش می‌توانید از پارامتر اختیاری cart_data استفاده کنید. این Object درون بدنه JSON درخواست ساخت تراکنش تعریف می‌شود و شامل سه بخش مجزا است:
items ،added_costs و deductions ساختار و توضیح هر بخش به شکل زیر است:
cart_dataاین object تمامی جزئیات سبد خرید را نگه می‌دارد و در زمان ایجاد تراکنش همراه سایر پارامترها ارسال می‌شود. استفاده از آن اختیاری است، اما توصیه می‌شود تا با درج آن، فرایند پرداخت برای خریدار شفاف‌تر شود.items: آرایه‌ای از محصولات یا خدمات سفارشنام نوع الزام توضیحات item_name String بله نام محصول یا خدمت item_amount String بله مبلغ هر واحد از کالا یا خدمت به ریال item_count String بله تعداد واحدهای مورد نظر از همان کالا یا خدمت item_amount_sum String بله مجموع مبلغ این کالا یا خدمت (حاصل ضرب item_amountدرitem_count). این مقدار را شما باید محاسبه و ارسال کنیدadded_costs: این object شامل هزینه‌های اضافی که به فاکتور اضافه می‌شود. تمامی فیلدهای این بخش اختیاری هستند.نام نوع الزام توضیحات tax String خیر مبلغ مالیات اعمال‌شده بر سبد خرید (ریال) payment String خیر کارمزد یا هزینه پرداخت (ریال) transport String خیر هزینه حمل و نقل یا ارسال (ریال) deductions: این object برای ثبت کسرها یا تخفیف‌ها. تمام فیلدهای این بخش نیز اختیاری هستند.نام نوع الزام توضیحات discount String خیر مبلغ تخفیف که از مجموع سبد خرید کم می‌شود (ریال)
مثال:
- نمونه درخواست
- درخواست
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": 150000,
"description": "پرداخت مربوط به سفارش شماره 1010 در فروشگاه تستی",
"metadata": {
"mobile": "09120000000",
"email": "user@example.com",
"order_id": "1234567890",
"card_pan": "502229XXXXXX1234"
},
"cart_data": {
"items": [
{
"item_name": "کفش ورزشی نایک",
"item_amount": 50000,
"item_count": 2,
"item_amount_sum": 100000
},
{
"item_name": "جوراب اسپرت",
"item_amount": 25000,
"item_count": 1,
"item_amount_sum": 25000
}
],
"added_costs": {
"tax": 5000,
"payment": 1000,
"transport": 2000
},
"deductions": {
"discount": 3000
}
},
"callback_url": "https://example.com/payment/verify"
}'