درگاه پرداخت
ایجاد فاکتور پرداخت
POST/api/gateway/create-invoiceنیازمند API Key
یک فاکتور پرداخت جدید برای مشتری شما ایجاد میکند و لینک صفحه پرداخت را برمیگرداند تا مشتری با ارز دیجیتال دلخواه خود آن را تسویه کند.
پارامترها
amountالزامی
مبلغ فاکتور، بر اساس واحد مشخصشده در to_currency.
order_idالزامی
شناسه سفارش در سیستم شما، برای پیگیری این تراکنش.
to_currencyاختیاری
واحد مبلغ amount. مقادیر مجاز: IRT، IRR، ROB، USD، AED، EUR، TRY، GBP، CNY، INR، PKR — پیشفرض USD.
currencyاختیاری
برای محدود کردن پرداخت به یک ارز دیجیتال مشخص (مثلاً USDT).
networkاختیاری
شبکه بلاکچین مشخص برای دریافت پرداخت، همراه با currency.
lifetimeاختیاری
مدت اعتبار فاکتور بر حسب دقیقه.
status_callbackاختیاری
مشتری پس از اتمام تراکنش با متد GET به این آدرس هدایت میشود.
success_callbackاختیاری
پس از پرداخت موفق، اطلاعات تراکنش با متد POST به این آدرس ارسال میشود.
fail_callbackاختیاری
در صورت شکست پرداخت، با متد POST فراخوانی میشود.
descriptionاختیاری
توضیح دلخواه شما برای این تراکنش.
نمونه پاسخ
موفق200
{
"status": 1,
"uuid": "a13f908c-5422-4b14-a832-1bed6ae6da7f",
"id": 1094,
"data": null,
"url": "https://ramzino.me/api/gateway/pay-invoice/a13f908c-5422-4b14-a832-1bed6ae6da7f"
}خطا400
{
"status": -1,
"errors": [
"وارد کردن فیلد api key الزامی است."
]
}