API – भुगतान बनाएं

भुगतान बनाएं

अपनी सेवा के भुगतान के लिए भुगतान लिंक बनाएं

URL

POST

https://api.fps.pro/invoices/create

अनुरोध प्रारूपapplication/json

`amount` required number	चयनित फिएट मुद्रा में भुगतान राशि
`currency` required string	स्वीकृत फिएट मुद्रा (फिएट सूची देखें)
`order_id` string	आपके सिस्टम में ऑर्डर ID
`network` string	आप वह नेटवर्क बता सकते हैं जहाँ भुगतान स्वीकार होना चाहिए, या किसी उपलब्ध नेटवर्क में स्वीकार करने के लिए फ़ील्ड खाली छोड़ सकते हैं
`webhook_link` url	URL जहाँ भुगतान स्थिति भेजी जाएगी डिफ़ॉल्ट: merchant settings
`success_link` url	सफल भुगतान के बाद ग्राहक को भेजने का URL डिफ़ॉल्ट: merchant settings
`error_link` url	असफल भुगतान के बाद ग्राहक को भेजने का URL डिफ़ॉल्ट: merchant settings
`part_payment` boolean	आप एक भुगतान में आंशिक भुगतान की अनुमति दे सकते हैं या रोक सकते हैं डिफ़ॉल्ट: true or merchant settings
`ignore_client_amount` boolean	यदि यह मान True है, तो ग्राहक द्वारा भुगतान की गई कोई भी राशि इनवॉइस को सफलतापूर्वक पूरा करेगी डिफ़ॉल्ट: false or merchant settings
`payment_accuracy` number	1 से 100 तक प्रतिशत मान दें। अगर $100 भुगतान के लिए 5 सेट है, तो ग्राहक $95 भुगतान करने पर भुगतान सफल माना जाएगा डिफ़ॉल्ट: 0 or merchant settings
`fee` number	1 से 100 तक मान जो भुगतान में प्रतिशत आधारित शुल्क जोड़ता है डिफ़ॉल्ट: 0
`discount` number	1 से 100 तक मान जो भुगतान पर निर्दिष्ट छूट प्रतिशत लागू करता है डिफ़ॉल्ट: 0
`additional_info` string	कोई भी जानकारी
`auto_convert` boolean	भुगतान प्राप्त होने के बाद ऑटो-कन्वर्ट करें डिफ़ॉल्ट: false

प्रतिक्रिया प्रारूपdata object

`id` uuid	इनवॉइस ID
`info.currency` string \| null	इनवॉइस की फिएट मुद्रा का कोड
`info.token` string \| null	भुगतान टोकन
`info.network` string \| null	भुगतान नेटवर्क
`info.address` string \| null	भुगतान के लिए वॉलेट पता
`amount.starting_price` number	फिएट में इनवॉइस की प्रारंभिक राशि
`amount.discount_percent` number	छूट राशि प्रतिशत में
`amount.merchant_fee_percent` number	मर्चेंट शुल्क प्रतिशत में
`amount.service_fee_percent` number \| null	प्लेटफ़ॉर्म सेवा शुल्क प्रतिशत में
`amount.total` number	छूट और शुल्क के बाद अंतिम राशि
`url.webhook` url \| null	मर्चेंट वेबहुक URL
`url.success` url \| null	सफल भुगतान के बाद रीडायरेक्ट URL
`url.error` url \| null	असफल भुगतान के बाद रीडायरेक्ट URL
`url.payment` url	भुगतान पेज लिंक
`options.part_payment` boolean	आंशिक भुगतान की अनुमति है या नहीं
`options.ignore_client_amount` boolean	ग्राहक की सटीक राशि को अनदेखा किया जाता है या नहीं
`options.payment_accuracy` number	अनुमत भुगतान सहनशीलता
`additional.order_id` string \| null	बाहरी ऑर्डर ID
`additional.info` string \| null	ऑर्डर की अतिरिक्त जानकारी
`status` string	इनवॉइस की वर्तमान स्थिति
`expired_at` string (ISO 8601, UTC)	इनवॉइस समाप्ति तिथि
`created_at` string (ISO 8601, UTC)	इनवॉइस निर्माण तिथि

अनुरोध उदाहरण

curl --request POST 'https://api.fps.pro/invoices/create' \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Id: YOUR_CLIENT_ID' \
  --header 'X-Timestamp: 1720000000' \
  --header 'X-Signature: YOUR_HMAC_SHA256_SIGNATURE' \
  --data '{
  "amount": 150.75,
  "currency": "usd",
  "order_id": "ORD-1001",
  "network": "tron",
  "webhook_link": "https://merchant.example.com/webhooks/fps",
  "success_link": "https://merchant.example.com/payments/success",
  "error_link": "https://merchant.example.com/payments/error",
  "part_payment": true,
  "ignore_client_amount": false,
  "payment_accuracy": 0,
  "fee": 1.5,
  "discount": 3,
  "additional_info": "Premium subscription",
  "auto_convert": false
}'

सफल प्रतिक्रिया

{
  "status": 201,
  "message": "invoice created",
  "data": {
    "id": "0a718b02-138d-495a-9661-39ca52139c07",
    "info": {
      "currency": "USD",
      "token": null,
      "network": null,
      "address": null
    },
    "amount": {
      "starting_price": 1000,
      "discount_percent": 0,
      "merchant_fee_percent": 10,
      "service_fee_percent": 1,
      "total": 1100
    },
    "url": {
      "webhook": "https://merchant.example/webhook",
      "success": "https://merchant.example/success",
      "error": "https://merchant.example/error",
      "payment": "https://frontend.example/0a718b02-138d-495a-9661-39ca52139c07"
    },
    "options": {
      "part_payment": true,
      "ignore_client_amount": false,
      "payment_accuracy": 0
    },
    "additional": {
      "order_id": "1",
      "info": ""
    },
    "status": "init",
    "expired_at": "2026-01-05 14:30:43",
    "created_at": "2026-01-05T13:30:43.000Z"
  }
}

त्रुटियां

प्राधिकरण त्रुटियों की विस्तृत सूची यहां दी गई है: प्राधिकरण - त्रुटियाँ

{
  "status": 422,
  "message": "Validation Error",
  "errors": [
    {
      "field": "currency",
      "message": "currency is required"
    }
  ]
}

{
  "status": 500,
  "message": "Internal Server Error"
}