API রেফারেন্স

API দ্রুত শুরু

একটি MakePay API কী তৈরি করুন এবং আপনার প্রথম সার্ভার অনুরোধ জমা দিন।

একটি দল এবং API কী চয়ন করুন

আপনি সাইন ইন করার সময় MakeCrypto পোর্টাল থেকে বা API টেস্টিং ট্যাব থেকে একটি MakePay API কী তৈরি করুন৷ API টেস্টিং ট্যাব আপনার দলগুলিকে লোড করে, MakePay API কীগুলিকে ফিল্টার করে, কী-সৃষ্টির মোডালটি খোলে, যখন একটি ZQPH2 নির্বাচিত দল এখনও ZQX2 কী পাঠাতে পারে না৷ নির্বাচিত কী আইডি এবং গোপনীয়তার সাথে প্রমাণীকৃত অনুরোধ।

বেস URL

সমস্ত MakeCrypto অংশীদার API রুট উত্পাদন উত্সের অধীনে সংস্করণ করা হয়েছে৷

https://www.makecrypto.io/api/partner/v1

স্থানীয় উন্নয়নের জন্য, একই পাথ কাঠামোর সাথে আপনার স্থানীয় MakeCrypto মূল ব্যবহার করুন।

প্রমাণীকরণ

সার্ভার ইন্টিগ্রেশন প্রতিটি অনুরোধে একটি MakePay API কী আইডি এবং API গোপন পাঠাতে হবে। API কী তৈরি করা হলেই গোপনটি ফেরত দেওয়া হয়, তাই এটিকে সার্ভার-সাইড সিক্রেট ম্যানেজারে রাখুন এবং কখনই গ্রাহক ব্রাউজারে পাঠাবেন না।

HeaderValueNotes
x-makecrypto-key-idMakePay API key IDMakePay payment APIs-এর জন্য mk_makepay_ দিয়ে শুরু হয়.
x-makecrypto-key-secretOne-time API secretশুধু key তৈরি করার সময় দেখানো হয়. এটি server-side secret manager-এ সংরক্ষণ করুন.

প্রথমে পড়ার অনুরোধ

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

curl
curl "https://www.makecrypto.io/api/partner/v1/makepay/payment-links" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Accept: application/json"

প্রথমে অনুরোধ তৈরি করুন

একটি অর্ডার, চালান, বা checkout সেশন অর্থপ্রদানের জন্য প্রস্তুত হলে আপনার সার্ভার থেকে অর্থপ্রদানের লিঙ্ক তৈরি করুন৷

curl
curl -X POST "https://www.makecrypto.io/api/partner/v1/makepay/payment-links" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "active",
  "sendPaymentRequestEmail": false,
  "payload": {
    "title": "Website order #1042",
    "description": "Checkout for order #1042",
    "amount": "129.99",
    "fiatCurrency": "USD",
    "currency": "USDT",
    "orderId": "order_1042",
    "customerEmail": "buyer@example.com",
    "returnUrl": "https://merchant.example/orders/1042",
    "successUrl": "https://merchant.example/orders/1042/success",
    "failureUrl": "https://merchant.example/orders/1042/failure",
    "expirationTime": "12h",
    "metadata": {
      "cartId": "cart_7M2V",
      "source": "api"
    }
  }
}'

অপারেশনাল চেকলিস্ট

  • makepay পণ্যের সাথে API কী তৈরি করুন।
  • লিঙ্ক তৈরি করার আগে কোম্পানির ডিফল্ট গন্তব্য সম্পদ কনফিগার করুন।
  • API সিক্রেট বাইরে সোর্স কন্ট্রোল এবং ফ্রন্টএন্ড বান্ডেল সংরক্ষণ করুন।
  • পেমেন্ট-লিঙ্ক ইউআইডিগুলিকে সর্বজনীন শনাক্তকারী হিসাবে বিবেচনা করুন, তবে অভ্যন্তরীণ অর্ডার আইডিগুলি payload.orderId বা payload.metadata-এ রাখুন৷
  • webhooks শুনুন বা আপনার ব্যাকএন্ড webhook ফ্লো লাইভ না হওয়া পর্যন্ত পোর্টাল থেকে পেমেন্ট-লিঙ্ক/সেশন স্টেট পোল করুন।

পার্টনার সেটআপে সাহায্য দরকার?

বাস্তব payment UID-এর জন্য generated snippets কপি করতে MakeCrypto-তে payment link details view খুলুন, অথবা merchant settings পরিচালনা করতে portal-এ ফিরে যান।

পোর্টাল খুলুন