PAYEXA SANDBOX LAB
این داشبورد برای شبیهسازی دقیق جریان پرداخت PAYEXA در محیط sandbox طراحی شده است؛ از ایجاد تراکنش و هدایت کاربر به startPay تا بررسی status، اجرای verify و مشاهده پاسخهای API در یک فضای متمرکز، شفاف و مناسب تست فنی.
فقط روی ساخت تراکنش جدید بزنید تا یک سناریوی تست با دادههای مناسب و نیمهرندوم ساخته شود.
از این بخش فقط وارد startPay شوید. عملیات موفق و ناموفق داخل خود صفحه پرداخت انجام میشود.
order_id و token از تراکنش انتخابشده پر میشوند، اما میتوانید دستی تغییرشان بدهید.
منتظر استعلام…
منتظر پاسخ…
منتظر verify…
منتظر پاسخ…
همه endpointها فقط با لینک sandbox، هدرهای لازم و نمونه body در کارتهای زیر آمدهاند.
برای محیط تست، به جای pay.pexn.ir از sandbox.pexn.ir استفاده کنید.
برای endpointهای API، هدرهای Content-Type: application/json و X-API-KEY: PAYEXA را بفرستید.
مسیر startPay فقط برای redirect کاربر است و از سمت سرور فراخوانی نمیشود.
برای همه درخواستهای اصلی همین هدرها را بفرستید و کلید را فقط در backend نگه دارید.
POST /v1/payment/request POST /v1/payment/verify GET /v1/payment/status
Content-Type: application/json X-API-KEY: PAYEXA
برای شروع پرداخت این endpoint را بزنید. بعد از گرفتن authority کاربر را به startPay بفرستید.
Content-Type: application/json X-API-KEY: PAYEXA
{
"amount": 250000,
"callback_url": "https://merchant.example.com/payexa/callback",
"meta": {
"order_ref": "INV-1001"
}
}
این آدرس فقط برای redirect کاربر در مرورگر است. آن را از سمت backend به عنوان API صدا نزنید.
ندارد این آدرس فقط برای redirect کاربر در مرورگر است.
authority را از پاسخ request بگیرید و کاربر را فقط به این آدرس redirect کنید.
بعد از callback، این endpoint را از سمت سرور خودتان بزنید. برای نهاییسازی سفارش فقط پاسخ موفق verify معیار است.
Content-Type: application/json X-API-KEY: PAYEXA
{
"order_id": "ORD-AB12CD34EF56",
"token": "249500"
}
برای مشاهده وضعیت فعلی سفارش از این endpoint استفاده کنید. برای نهاییسازی سفارش، verify همچنان مهمتر است.
X-API-KEY: PAYEXA
برای نمایش وضعیت فعلی سفارش استفاده کنید. برای نهایی کردن سفارش، verify مهمتر است.