پرش به محتوای اصلی

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 }'

کلید آزمایشی خود را بگیرید

ثبت‌نام چند دقیقه طول می‌کشد و کلید آزمایشی بلافاصله در دسترس است.

هزینهٔ ثبت‌نامندارد
کارمزدفقط تراکنش موفق