API রেফারেন্স

পেমেন্ট লিঙ্ক API

MakePay পেমেন্ট লিঙ্কগুলি তৈরি করুন, তালিকাভুক্ত করুন, পরিদর্শন করুন, বিরতি দিন, সংরক্ষণাগার করুন এবং পাঠান।

রুট

MakeCrypto থেকে হোস্ট করা MakePay পেমেন্ট লিঙ্ক তৈরি এবং পরিচালনা করতে এই রুটগুলি ব্যবহার করুন৷

Method	Route
GET	`/api/partner/v1/companies`
Auth session Use ব্যবহারকারীর companies তালিকা authenticated MakeCrypto user-এর portal tools-এর জন্য উপলভ্য teams ফেরত দেয়.
POST	`/api/partner/v1/onboarding/company`
Auth partner onboarding secret Use Company onboarding link তৈরি করুন partner-pre-filled onboarding draft তৈরি করে এবং merchant-এর জন্য claim URL ফেরত দেয়.
GET	`/api/partner/v1/makepay/payment-links`
Auth MakePay API key Use Payment links তালিকা করুন বা তৈরি করুন API key-এর company payment links পড়ে বা hosted MakePay checkout links তৈরি করে.
POST	`/api/partner/v1/makepay/payment-links`
Auth MakePay API key অথবা public Use Payment links তালিকা করুন বা তৈরি করুন API key-এর company payment links পড়ে বা hosted MakePay checkout links তৈরি করে.
POST	`/gateway/pay/{makepayKeyId}`
Auth public form key Use HTML payment form submit করুন browser form fields গ্রহণ করে, hosted payment link তৈরি করে এবং shopper-কে checkout-এ redirect করে.
GET	`/api/partner/v1/makepay/payment-links/{uid}`
Auth MakePay API key Use Payment link পড়ুন বা update করুন payment link detail পড়ে বা status active, paused, অথবা archived-এ পরিবর্তন করে.
PATCH	`/api/partner/v1/makepay/payment-links/{uid}`
Auth MakePay API key Use Payment link পড়ুন বা update করুন payment link detail পড়ে বা status active, paused, অথবা archived-এ পরিবর্তন করে.
POST	`/api/partner/v1/makepay/payment-links/{uid}/send-request-email`
Auth MakePay API key Use Payment request পাঠান hosted link customer email-এ পাঠায় বা আবার পাঠায়.
GET	`/api/partner/v1/makepay/subscriptions`
Auth MakePay API key Use Subscriptions তালিকা করুন বা তৈরি করুন recurring MakePay subscription plans ফেরত দেয় বা subscription এবং প্রথম invoice তৈরি করে.
POST	`/api/partner/v1/makepay/subscriptions`
Auth MakePay API key Use Subscriptions তালিকা করুন বা তৈরি করুন recurring MakePay subscription plans ফেরত দেয় বা subscription এবং প্রথম invoice তৈরি করে.
GET	`/api/partner/v1/makepay/customers`
Auth MakePay API key Use Customers তালিকা করুন বা update করুন MakePay customer profiles ফেরত দেয় অথবা email দিয়ে customers create/update করে.
POST	`/api/partner/v1/makepay/customers`
Auth MakePay API key Use Customers তালিকা করুন বা update করুন MakePay customer profiles ফেরত দেয় অথবা email দিয়ে customers create/update করে.
POST	`/api/partner/v1/makepay/customers/{customerId}/portal`
Auth MakePay API key Use Customer portal link তৈরি করুন 24 ঘণ্টার জন্য valid signed MakePay customer portal URL on demand তৈরি করে.
GET	`/api/partner/v1/timezones`
Auth public Use Timezones তালিকা করুন supported IANA timezone identifiers ফেরত দেয়.
GET	`/api/partner/v1/makepay/settings`
Auth MakePay API key Use MakePay settings পড়ুন বা update করুন settlement, redirects, fees, এবং underpayment handling settings পড়ে বা update করে.
PUT	`/api/partner/v1/makepay/settings`
Auth MakePay API key Use MakePay settings পড়ুন বা update করুন settlement, redirects, fees, এবং underpayment handling settings পড়ে বা update করে.
GET	`/api/partner/v1/makepay/destination-assets`
Auth MakePay API key Use Destination assets তালিকা করুন supported settlement assets এবং current default asset ফেরত দেয়.
GET	`/api/partner/v1/makepay/webhook-requests`
Auth MakePay API key Use Webhook deliveries তালিকা করুন payment এবং subscription webhook delivery attempts ও retry status দেখায়.

একটি পেমেন্ট লিঙ্ক তৈরি করুন

তৈরি রুট একটি MakePay পেমেন্ট লিঙ্ক সন্নিবেশ করায়, merchant ব্র্যান্ডিং এবং সেটেলমেন্ট ডিফল্টগুলি সমাধান করে, রানটাইম বিলিং ক্ষেত্রগুলিকে ইনজেকশন করে এবং সর্বজনীন checkout URL ফেরত দেয়।

POST /api/partner/v1/makepay/payment-links

json

{
  "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"
    }
  }
}

নো-কোড বা লো-কোড ব্রাউজার checkout বোতামের জন্য, ফর্ম জমা পেমেন্ট দেখুন। এটি একটি সাধারণ HTML POST গ্রহণ করে, একই ধরনের হোস্ট করা পেমেন্ট লিঙ্ক তৈরি করে এবং ক্রেতাকে MakePay checkout-এ পুনঃনির্দেশ করে।

প্রয়োজনীয় সেটআপ

কোম্পানির অবশ্যই একটি MakePay ডিফল্ট গন্তব্য সম্পদ থাকতে হবে। সেটেলমেন্ট কনফিগার করা না হলে, রুট errorCode: "onboarding_required" এর সাথে 409 ফেরত দেয়।

পরিমাণ এবং সম্পদ ক্ষেত্র

গ্রাহক-মুখী পরিমাণের জন্য payload.amount ব্যবহার করুন। একটি সঠিক গন্তব্য সম্পদের জন্য payload.asset বা payload.currency পাস করুন যখন কোম্পানির ডিফল্ট গন্তব্য সম্পদ চেইন সমাধান করতে পারে। যদি একাধিক চেইনে একটি মুদ্রা সক্ষম করা থাকে এবং কোনো মিলিত কোম্পানির ডিফল্ট বিদ্যমান না থাকে, তাহলে payload.asset স্পষ্টভাবে পাস করুন।

মেয়াদ শেষ

payload.expirationTime 15m, 1h, 12h, 24h, 72h, বা never গ্রহণ করে। API পেমেন্ট লিঙ্কে সমাধান করা expires_at টাইমস্ট্যাম্প সংরক্ষণ করে।

প্রতিক্রিয়া তৈরি করুন

json

{
  "ok": true,
  "paymentRequestEmailSent": false,
  "paymentRequestEmailError": null,
  "paymentLink": {
    "id": "8d15bb78-d0f8-45ef-88d7-2a1f1f79644b",
    "uid": "01hzy4k6p4w9y2x7e2z7n8a2xm",
    "status": "active",
    "expires_at": "2026-04-19T12:00:00.000Z",
    "created_at": "2026-04-19T00:00:00.000Z",
    "updated_at": "2026-04-19T00:00:00.000Z",
    "publicUrl": "https://makepay.io/payment/01hzy4k6p4w9y2x7e2z7n8a2xm",
    "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"
      },
      "asset": "ETH.USDT-0xdac17f958d2ee523a2206206994597c13d831ec7",
      "runtimeMode": "merchant_target_net_v2",
      "billingVersion": "v2",
      "merchantName": "Merchant Co",
      "merchantPaymentLinkTheme": "system"
    }
  }
}

পেমেন্ট লিঙ্ক তালিকা

ব্যাক-অফিস পুনর্মিলন, ড্যাশবোর্ড এবং ধোঁয়া পরীক্ষার জন্য তালিকা রুট ব্যবহার করুন।

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"

পেমেন্ট লিঙ্ক বিস্তারিত পান

আপনার কাছে ইতিমধ্যেই একটি পেমেন্ট-লিঙ্ক UID থাকলে বিস্তারিত রুট ব্যবহার করুন এবং স্বাভাবিক করা লিঙ্ক, সর্বজনীন checkout URL, সর্বশেষ পেমেন্ট সেশন এবং টাইমলাইন ইভেন্টের প্রয়োজন।

curl

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

একটি পেমেন্ট লিঙ্ক বিরতি বা সংরক্ষণাগার

একটি লিঙ্ককে অর্থপ্রদান করা বন্ধ করতে বা সক্রিয় ক্রিয়াকলাপগুলি থেকে লুকানোর জন্য স্ট্যাটাস রুট ব্যবহার করুন৷

curl

curl -X PATCH "https://www.makecrypto.io/api/partner/v1/makepay/payment-links/PAYMENT_LINK_UID" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"status":"paused"}'

status অবশ্যই active, paused বা archived হতে হবে।

একটি পেমেন্ট অনুরোধ ইমেল পাঠান

MakeCrypto হোস্ট করা লিঙ্কটিকে সরাসরি পেমেন্ট-লিঙ্ক পেলোডে গ্রাহকের ইমেলে বা অনুরোধের অংশে একটি ওভাররাইড ইমেলে পাঠাতে পারে।

curl

curl -X POST "https://www.makecrypto.io/api/partner/v1/makepay/payment-links/PAYMENT_LINK_UID/send-request-email" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"email":"buyer@example.com"}'

শুধুমাত্র সক্রিয় পেমেন্ট লিঙ্ক ইমেল করা যাবে. সম্পূর্ণ পেমেন্ট লিঙ্ক পুনরায় পাঠানো যাবে না.