HandyPay

HandyPay ইকমার্স পেমেন্ট API

যে কোনও অ্যাপ্লিকেশনে REST HandyPay অর্থপ্রদানকে একীভূত করার জন্য API সর্বজনীন করুন। API কী দিয়ে প্রমাণীকরণ করুন, পণ্য, গ্রাহক, অর্থপ্রদানের অধিবেশন, সাবস্ক্রিপশন পরিচালনা করুন এবং ওয়েবহুক বিজ্ঞপ্তি গ্রহণ করুন।

বেস URL

https://api.handypay.me/api/v1
javascript

API সংস্করণঃ 2025-01-01 - ফিরে আসে X-API-Version প্রতিটি প্রতিক্রিয়ায় হেড।

দ্রুত শুরু

এক মিনিটের মধ্যে উঠে দাঁড়ান। একটি API কী নিন, ক্লায়েন্ট সেট আপ করুন, একটি অনুরোধ করুন।

1

আপনার API কী পান

থেকে কী তৈরি করুন মার্চেন্ট পোর্টালসমস্ত অনুরোধের জন্য একটি বাহক টোকেনের প্রয়োজন হয় Authorization হেডার।

Authorization: Bearer hp_live_your_api_key_here
javascript
hp_test_স্যান্ডবক্স
hp_live_উৎপাদন
2

API ক্লায়েন্ট সেট আপ করুন

একটি পুনঃব্যবহারযোগ্য সহায়ক তৈরি করুন। এটি Next.js, React Native এবং Node.js-এ কাজ করে।

lib/handypay.ts
const HANDYPAY_API_URL = "https://api.handypay.me/api/v1";
const HANDYPAY_API_KEY = process.env.HANDYPAY_API_KEY!;

async function handypay<T = any>(
  endpoint: string,
  options: RequestInit = {}
): Promise<T> {
  const res = await fetch(`${HANDYPAY_API_URL}${endpoint}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${HANDYPAY_API_KEY}`,
      "Content-Type": "application/json",
      ...options.headers,
    },
  });

  const json = await res.json();

  if (!json.success) {
    throw new Error(`[${json.error.code}] ${json.error.message}`);
  }

  return json.data;
}

export { handypay };
javascript

আপনার চাবিটি সংরক্ষণ করুন .env যেমন HANDYPAY_API_KEYকখনই ক্লায়েন্টের পক্ষ থেকে প্রকাশ করবেন না।

3

আপনার প্রথম অনুরোধ করুন

সবকিছু কাজ করে কিনা তা যাচাই করার জন্য আপনার পণ্যগুলি তালিকাভুক্ত করুন।

TypeScript
const products = await handypay("/products?limit=10");
console.log(products);
javascript
cURL সমতুল্য
cURL
curl https://api.handypay.me/api/v1/products \
  -H "Authorization: Bearer hp_test_your_api_key_here"
javascript

আপনার JSON-এর প্রতিক্রিয়া পাওয়া উচিত "success": true এবং আপনার পণ্যের তথ্য।

হারের সীমা

API কী-তে প্রতি ঘন্টায় 1,000 অনুরোধ। সীমা অতিক্রম করে ফেরত 429 সঙ্গে একটি Retry-After হেডার।

আপনি যা তৈরি করতে পারেন

এককালীন পেমেন্ট

একক ক্রয়ের জন্য পণ্য তৈরি করুন এবং হোস্ট করা চেকআউট সেশন তৈরি করুন।

সাবস্ক্রিপশন

নমনীয় বিরতি, পরীক্ষা এবং বাতিলকরণ সহ বিলিং পুনরাবৃত্তি করা।

বহু-মুদ্রা

USD, JMD, CAD এবং আরও অনেক কিছু 10 দেশ জুড়ে গ্রহণ করুন।

Webhooks

অর্থ প্রদান এবং সাবস্ক্রিপশন জীবনচক্রের জন্য রিয়েল-টাইম ইভেন্ট বিজ্ঞপ্তি।

বিলিং ব্যবধান

সাবস্ক্রিপশন পণ্যগুলি নিম্নলিখিত পুনরাবৃত্ত বিলিং ব্যবধানগুলিকে সমর্থন করে।

weeklybi-weeklymonthlybi-monthlyquarterlysemi-annualannual

পরবর্তী পদক্ষেপ

এন্ডপয়েন্টের বিস্তারিত জানতে সম্পূর্ণ API রেফারেন্স দেখুন, অথবা Next.js, React Native ও Express-এর ইন্টিগ্রেশন রেসিপিতে সরাসরি যান।