গ্রাহক পোর্টাল API

একটি পোর্টাল লিঙ্ক তৈরি করুন

একটি সঞ্চিত MakePay গ্রাহক প্রোফাইল থেকে একটি MakePay গ্রাহক পোর্টাল লিঙ্ক তৈরি করুন৷ গ্রাহক বা merchant বিলিং-এ ক্লিক করলেই লিঙ্ক তৈরি করুন, তারপর রিডাইরেক্ট করুন বা রিটার্ন করা URL খুলুন।

POST /api/partner/v1/makepay/customers/{customerId}/portal

customerId সঞ্চিত গ্রাহক UUID বা গ্রাহক UID গ্রহণ করে। অনুরোধের বডি খালি।

curl -X POST "https://www.makecrypto.io/api/partner/v1/makepay/customers/CUSTOMER_ID/portal" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Accept: application/json"

প্রমাণীকরণ

সার্ভার ইন্টিগ্রেশন একটি MakePay API কী দিয়ে প্রমাণীকরণ করে। যখন সাইন-ইন করা ব্যবহারকারীর নির্বাচিত দলে settings.manage থাকে তখন ব্রাউজার সেশনগুলি কোম্পানি-স্কোপড ড্যাশবোর্ড রুটকে কল করতে পারে। API-কী অনুরোধগুলি URL-এ কোম্পানির আইডি পাস করে না কারণ কীটি ইতিমধ্যেই একটি কোম্পানির অন্তর্গত।

প্রতিক্রিয়া

রুট গ্রাহক বস্তুর সাথে একটি স্বাক্ষরিত urls.customerPortal লিঙ্ক প্রদান করে।

{
  "ok": true,
  "companyId": "acct_123",
  "customer": {
    "id": "b834dd77-69b8-41a9-a4b6-95bc9dd14c2d",
    "uid": "cus_01hzy4k6p4w9y2x7e2z7n8a2xm",
    "email": "buyer@example.com",
    "name": "Ada Lovelace",
    "clientId": "client_1042",
    "metadata": {
      "source": "api"
    },
    "createdAt": "2026-04-20T10:00:00.000Z",
    "updatedAt": "2026-04-20T10:00:00.000Z",
    "urls": {
      "customerPortal": "https://makepay.io/billing?company=acct_123&customer=cus_01hzy4k6p4w9y2x7e2z7n8a2xm&expires=1776765600&signature=8d1f..."
    }
  },
  "expiresAt": "2026-04-21T10:00:00.000Z"
}

স্বাক্ষরিত URL পরামিতি

ফিরে আসা পোর্টাল URL এর এই আকৃতি রয়েছে:

https://{makepay-or-verified-merchant-domain}/billing?company={companyId}&customer={customerUid}&expires={unixSeconds}&signature={hexHmac}

MakePay কোনো পোর্টাল ডেটা লোড করার আগে স্বাক্ষর এবং মেয়াদ শেষ হয়ে গেছে তা যাচাই করে। স্থায়ীভাবে পোর্টাল URL সংরক্ষণ করবেন না. প্রতিটি বোতাম ক্লিকে একটি নতুন লিঙ্ক পুনরায় তৈরি করুন।

পোর্টাল সুযোগ

পোর্টাল শুধুমাত্র এমন ডেটা দেখায় যা স্বাক্ষরিত কোম্পানি এবং গ্রাহকের সাথে মেলে:

• গ্রাহক প্রোফাইল সারাংশ এবং সম্পাদনাযোগ্য প্রদর্শন নাম।
• পেমেন্ট ইতিহাস গ্রাহকের ইমেল বা ক্লায়েন্ট আইডি দ্বারা মেলে।
• হোস্ট করা MakePay ইউআরএলগুলির সাথে সক্রিয় বা অবৈতনিক পেমেন্ট লিঙ্ক।
• গ্রাহক ইমেল বা মেটাডেটা ক্লায়েন্ট আইডি দ্বারা মেলে সদস্যতা.
• সমর্থিত সাবস্ক্রিপশন স্টেটের জন্য বিরাম দিন, পুনরায় সক্রিয় করুন এবং বাতিল করুন।

প্রথম পোর্টাল সংস্করণে ইমেল, ক্লায়েন্ট আইডি, পিডিএফ, অর্থপ্রদানের পদ্ধতি, লাইসেন্স কী, প্ল্যান স্যুইচিং এবং বাতিল-সাবস্ক্রিপশন সারসংকলন প্রবাহ পরিবর্তনযোগ্য নয়।