API درگاه پرداختی که پیشبینیپذیر رفتار میکند
مستنداتی که از خود کد سرور ساخته میشوند، محیط آزمایشی که خطاها را هم شبیهسازی میکند، و شناسهٔ درخواست در هر پاسخ تا پیدا کردن مشکل چند دقیقه طول بکشد، نه چند روز.
مبالغ API به ریال و عدد صحیح است. کلید آزمایشی بلافاصله پس از ثبتنام ساخته میشود.
۱. ساخت پرداخت
سرور شما مبلغ، آدرس بازگشت و شناسهٔ سفارش را میفرستد و آدرس صفحهٔ پرداخت را میگیرد.
curl -X POST https://api.sheypay.ir/api/v1/payments \
-H "Authorization: Bearer sk_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1042-create-1" \
-d '{
"amount": 1500000,
"callback_url": "https://shop.example.ir/payment/callback",
"merchant_reference": "ORDER-1042-1",
"description": "خرید سفارش ۱۰۴۲",
"mobile": "09121234567"
}'۲. تأیید پرداخت
در آدرس بازگشت، پرداخت را با مبلغ سفارش تأیید کنید. تا پاسخ verify موفق نیامده، سفارش را تحویل ندهید.
curl -X POST https://api.sheypay.ir/api/v1/payments/PAYMENT_ID/verify \
-H "Authorization: Bearer sk_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "amount": 1500000 }'ابزارها و منابع
- مستنداتراهنمای گام به گام پرداخت، تأیید، استرداد و وبهوک.
- OpenAPI 3.1مستند ماشینخوان برای ساخت کلاینت و تست خودکار.
- محیط آزمایشیموفق، ناموفق، انصراف و تأخیر بانک، بدون پول واقعی.
- وبهوکامضای HMAC، تلاش دوباره و تاریخچهٔ ارسال در پنل.
- Idempotencyتکرار امن درخواستها بدون پرداخت یا استرداد تکراری.
- Postmanمجموعهٔ آماده برای شروع بدون کدنویسی.
- افزونهها و SDKافزونهٔ ووکامرس و کتابخانهٔ PHP.
کلید آزمایشی خود را بگیرید
ثبتنام چند دقیقه طول میکشد و کلید آزمایشی بلافاصله در دسترس است.