প্রিপেইড অ্যাকাউন্টের ব্যালেন্স ম্যানেজ করা

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন।
তথ্য

প্রিপেড অ্যাকাউন্টের ব্যালেন্স ম্যানেজ করতে, আপনি এগুলি করতে পারেন:

প্রিপেইড অ্যাকাউন্টে কত ব্যালেন্স বাকি আছে তা আমি কীভাবে হিসেব করব?

নিম্নলিখিত বিভাগে বর্ণিত ডেভেলপার বা কোম্পানির জন্য প্রিপেড অ্যাকাউন্টের ব্যালেন্স দেখার সময়, আপনাকে রেসপন্স থেকে নিম্নলিখিত ভ্যালুগুলি পেতে হবে:

  • amount: বর্তমান বিলিং চক্রের জন্য উপলভ্য অর্থের মোট পরিমাণ। এই বিভাগে বর্ণিত পদ্ধতি ব্যবহার করে আপনি প্রিপেড অ্যাকাউন্ট আবার লোড করলে এই ভ্যালু আপডেট করা হয়।
  • usage: বর্তমান বিলিং চক্রে মোট কত টাকা ব্যবহার করা হয়েছে। এই ভ্যালু প্রতিটি উপযুক্ত মনিটাইজ করা ট্রানজ্যাকশন বা ক্রেডিট ইস্যু করার (ধনাত্মক বা ঋণাত্মক) মাধ্যমে আপডেট করা হয়।

usage ভ্যালু থেকে amount ভ্যালু বিয়োগ করে আপনি বর্তমান বিলিং মেয়াদের জন্য প্রিপেড অ্যাকাউন্টে বাকি থাকা ব্যালেন্স হিসেব করতে পারবেন। যেমন, amount ভ্যালু ৩৩৫.৫০ এবং usage ভ্যালু ৩৪ হলে, বাকি ব্যালেন্স নিম্নলিখিতভাবে হিসেব করা হবে:

amount(335.50) - usage(34) = 229.50

API ব্যবহার করে প্রিপেইড অ্যাকাউন্টের ব্যালেন্স দেখা

API ব্যবহার করে কীভাবে কোনও ডেভেলপার বা কোম্পানির প্রিপেড অ্যাকাউন্টের ব্যালেন্স দেখবেন তা নিম্নলিখিত বিভাগ থেকে জানতে পারবেন।

কোনও ডেভেলপারের প্রিপেইড অ্যাকাউন্ট ব্যালেন্স দেখা

কোনও ডেভেলপারের জন্য প্রিপেড অ্যাকাউন্টের ব্যালেন্স দেখতে, নিম্নলিখিত API-এর মধ্যে একটিতে GET অনুরোধ ইস্যু করুন, যেখানে {developer_id} হল ডেভেলপারের ইমেল আইডি:

  • /mint/organizations/{org_name}/developers/{developer_id}/developer-balances: কোনও ডেভেলপারের জন্য প্রিপেড অ্যাকাউন্টের ব্যালেন্স ও রেকারিং সেট-আপ সংক্রান্ত তথ্য রিটার্ন করে।
  • /mint/organizations/{org_name}/developers/{developer_id}/prepaid-developer-balances: প্রিপেড অ্যাকাউন্ট ব্যালেন্স সংক্রান্ত তথ্য ফেরত দেয়, যার মধ্যে বর্তমান ও মোট ব্যালেন্স, ব্যবহার, টপ-আপ ও ব্যবহার সংক্রান্ত ট্যাক্স অন্তর্ভুক্ত।

ফলাফল ফিল্টার করতে আপনি নিম্নলিখিত কোয়েরি প্যারামিটার পাস করতে পারেন:

কোয়েরি প্যারামিটার বিবরণ
all সব API প্যাকেজ রিটার্ন করা হবে কিনা তা নির্দিষ্ট করে এমন ফ্ল্যাগ। false হিসেবে সেট করা থাকলে, প্রতি পৃষ্ঠায় রিটার্ন করা API প্যাকেজের সংখ্যা size কোয়েরি প্যারামিটার দ্বারা নির্ধারিত হয়। ডিফল্ট হিসেবে false সেট করা থাকে।
size প্রতি পৃষ্ঠায় API প্যাকেজের সংখ্যা। ডিফল্ট মান ২০। all query প্যারামিটার true হিসেবে সেট করা থাকলে, এই প্যারামিটার উপেক্ষা করা হয়।
page আপনি যে পৃষ্ঠায় ফিরে যেতে চান তার নম্বর (কন্টেন্ট পৃষ্ঠায় ভাগ করা থাকলে)। all কোয়েরি প্যারামিটার true হিসেবে সেট করা থাকলে, এই প্যারামিটারটি উপেক্ষা করা হয়।
currencyId আপনি যে মুদ্রার প্রিপেড অ্যাকাউন্ট ব্যালেন্স দেখতে চান সেটির আইডি।

যেমন:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password

উত্তরের একটি উদাহরণ নিচে দেওয়া হল:

{
    "developerBalance": [
        {
            "amount": 2005,
            "chargePerUsage": false,
            "id": "your-provider-id",
            "isRecurring": false,
            "supportedCurrency": {
                "description": "United States Dollars",
                "displayName": "United States Dollars",
                "id": "usd",
                "name": "USD",
                "organization": {
                    "address": [
                        {
                            "address1": "10 Almaden Blvd.",
                            "city": "San Jose",
                            "country": "US",
                            "id": "32e808d8-3a3c-4d76-a0ae-17d70a982c61",
                            "isPrimary": true,
                            "state": "CA",
                            "zip": "95113"
                        }
                    ],
                    "approveTrusted": false,
                    "approveUntrusted": false,
                    "billingCycle": "CALENDAR_MONTH",
                    "country": "US",
                    "currency": "USD",
                    "description": "my-org",
                    "groupOrganization": false,
                    "hasBillingAdjustment": false,
                    "hasBroker": false,
                    "hasSelfBilling": false,
                    "hasSeparateInvoiceForProduct": false,
                    "id": "my-org",
                    "issueNettingStmt": false,
                    "name": "my-org",
                    "nettingStmtPerCurrency": false,
                    "selfBillingAsExchOrg": false,
                    "selfBillingForAllDev": false,
                    "separateInvoiceForFees": false,
                    "status": "ACTIVE",
                    "supportedBillingType": "BOTH",
                    "taxModel": "HYBRID",
                    "timezone": "UTC"
                },
                "status": "ACTIVE",
                "virtualCurrency": false
            },
            "usage": 2.1572
        }
    ],
    "totalRecords": 1
}

কোনও কোম্পানির প্রিপেইড অ্যাকাউন্ট ব্যালেন্স দেখা

কোনও কোম্পানির জন্য প্রিপেড অ্যাকাউন্টের ব্যালেন্স দেখতে, /mint/organizations/{org_name}/companies/{company_id}/developer-balances-এ একটি GET অনুরোধ ইস্যু করুন, যেখানে {company_id} হল কোম্পানির আইডি। কোম্পানি প্রিপেড হলে, অনুরোধ বর্তমান প্রিপেড অ্যাকাউন্টের ব্যালেন্স দেখায়। কোম্পানি পোস্টপেইড হলে, অনুরোধটি বর্তমান ক্রেডিট সীমা রিট্রিভ করে।

ফলাফল ফিল্টার করতে আপনি নিম্নলিখিত কোয়েরি প্যারামিটার পাস করতে পারেন:

কোয়েরি প্যারামিটার বিবরণ
all সব API প্যাকেজ রিটার্ন করা হবে কিনা তা নির্দিষ্ট করে এমন ফ্ল্যাগ। false হিসেবে সেট করা থাকলে, প্রতি পৃষ্ঠায় রিটার্ন করা API প্যাকেজের সংখ্যা size কোয়েরি প্যারামিটার দ্বারা নির্ধারিত হয়। ডিফল্ট হিসেবে false সেট করা থাকে।
size প্রতি পৃষ্ঠায় API প্যাকেজের সংখ্যা। ডিফল্ট মান ২০। all query প্যারামিটার true হিসেবে সেট করা থাকলে, এই প্যারামিটার উপেক্ষা করা হয়।
page আপনি যে পৃষ্ঠায় ফিরে যেতে চান তার নম্বর (কন্টেন্ট পৃষ্ঠায় ভাগ করা থাকলে)। all কোয়েরি প্যারামিটার true হিসেবে সেট করা থাকলে, এই প্যারামিটারটি উপেক্ষা করা হয়।
currencyId আপনি যে মুদ্রার প্রিপেড অ্যাকাউন্ট ব্যালেন্স দেখতে চান সেটির আইডি।

যেমন:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password

ডেভেলপারের জন্য প্রিপেড অ্যাকাউন্টের ব্যালেন্স দেখার সময় উপরে দেখানো উত্তরের মতো উত্তর দেওয়া হয়েছে।

পেমেন্ট পরিষেবা প্রদানকারীর মাধ্যমে প্রিপেইড অ্যাকাউন্ট ব্যালেন্স ম্যানেজ করা

Worldpay-এর মতো থার্ড-পার্টি পেমেন্ট পরিষেবা প্রদানকারীর সাথে মার্চেন্ট অ্যাকাউন্ট সেট-আপ করে প্রিপেড অ্যাকাউন্টের ব্যালেন্স ম্যানেজ করুন। Worldpay পেমেন্ট পরিষেবা প্রদানকারী ব্যবহার করে কীভাবে প্রিপেড অ্যাকাউন্ট ব্যালেন্স ম্যানেজ করা হয় তা নিম্নলিখিত চিত্রে দেখানো হয়েছে ।

Worldpay পেমেন্ট প্রদানকারীর ফ্লো

উপরের প্রিপেড অ্যাকাউন্ট ব্যালেন্স ম্যানেজমেন্ট ফ্লোতে দেখানো প্রতিটি ধাপের বিবরণ নিম্নলিখিত সারণীতে দেওয়া হল।

ধাপ বিবরণ
০ পূর্বশর্ত
API প্রদানকারী হিসেবে, Worldpay-এর মতো থার্ড-পার্টি পেমেন্ট প্রদানকারী সেট-আপ করতে, আপনাকে এগুলি অবশ্যই করতে হবে:
১ ফ্লো ট্রিগার করতে, API কনজিউমার ডেভেলপার পোর্টালে নিম্নলিখিত টাস্কের মধ্যে একটি পারফর্ম করে:
  • অ্যাকাউন্টে টাকা যোগ করে
  • পর্যাপ্ত ফান্ড না থাকা সত্ত্বেও রেট প্ল্যান গ্রহণ করা হয়
২ প্রোভাইডার আইডি, রিলোড করার পরিমাণ ও মুদ্রা সহ ডেভেলপারদের জন্য Edge-এর মাধ্যমে ডেভেলপার পোর্টাল পেমেন্ট শুরু করে। পেমেন্ট শুরু করার জন্য API ব্যবহার করা সম্পর্কে তথ্য পেতে, পেমেন্ট প্রদানকারী ব্যবহার করে প্রিপেড অ্যাকাউন্টে পেমেন্ট শুরু করা দেখুন।
৩ Edge, আইডি দিয়ে পরিষেবা প্রদানকারীকে খুঁজে পায় এবং নির্ধারণ করে যে এটি একটি Worldpay অ্যাকাউন্ট।
৪ Edge একটি অর্ডার কোড তৈরি করে।
৫ Edge, Worldpay-তে পেমেন্ট অর্ডার তৈরি করে।
৬ Worldpay অর্ডারটির জন্য একটি রেফারেন্স আইডি এবং এটি সম্পূর্ণ করার জন্য একটি সীমিত সময়ের URL রিটার্ন করে।
৭ Worldpay-এর উত্তরকে একটি জেনেরিক Edge /পেমেন্ট API উত্তরে কনভার্ট করা হয়, যা ২ নম্বর ধাপে শুরু করা কল সম্পূর্ণ করতে ডেভেলপার পোর্টালকে ফেরত পাঠানো হয়। যেমন:
{
    "isRecurring": "false",
    "orderCode": "1234",
    "referenceId": "3042815493",
    "referenceUrl": "https://secure.worldpay.com/wcc/dispatcher?OrderKey=MERCH_CODE_FROM_PROVIDER%5E1234",
    "success": "true"
}
৮ ডেভেলপার পোর্টাল, URL-এ কোয়েরি প্যারামিটার হিসেবে কলব্যাক URL (সফল, ব্যর্থ ইত্যাদি) যোগ করে।
9 ডেভেলপার পোর্টাল, API কনজিউমারের ব্রাউজারকে পরিবর্তিত URL-এ রিডাইরেক্ট করে ১ নম্বর ধাপে করা অনুরোধের উত্তর দেয়।
১০ API কনজিউমার আবেদনের ফর্ম পূরণ করে এবং Worldpay-এর মাধ্যমে প্রসেসিং শুরু করে।
১১ Worldpay বিলিং তথ্য ক্যাপচার করে এবং পেমেন্ট প্রসেস করে। সফল হলে, Worldpay Worldpay এবং ডেভেলপার পোর্টাল, এই দুটি জায়গাতেই কনফিগার করা MAC সিক্রেট ব্যবহার করে একটি মেসেজ যাচাইকরণ কোড (MAC) তৈরি করে।
১২ Worldpay API কনজিউমারের ব্রাউজারকে সফল কলব্যাক URL-এ (ধাপ ৮ থেকে) রিডাইরেক্ট করে, কোয়েরি প্যারামিটার হিসেবে MAC এবং টাকার পরিমাণ যোগ করে।
১৩ অনুরোধ করা পরিমাণ ও MAC সহ ডেভেলপার পোর্টালের URL-এ ব্রাউজার কল করে।
১৪ MAC সিক্রেটের সাথে MAC মিলিয়ে পোর্টাল যাচাই করে। MAC-এর মাধ্যমে কোনও ব্যক্তি যথেচ্ছভাবে দাবি করতে পারেন না যে পেমেন্ট সফলভাবে করা হয়েছে।
১৫ প্রিপেড অ্যাকাউন্টের ব্যালেন্স আবার লোড করার জন্য ডেভেলপার পোর্টাল Edge-এ অনুরোধ পাঠায়। অ্যাকাউন্ট ব্যালেন্স রিলোড করার জন্য API ব্যবহার করা সংক্রান্ত তথ্যের জন্য, API ব্যবহার করে প্রিপেড অ্যাকাউন্টের ব্যালেন্স রিলোড করা দেখুন।

নিম্নলিখিত বিভাগে থার্ড-পার্টি পেমেন্ট প্রদানকারী ব্যবহার করে প্রিপেড ব্যালেন্স ম্যানেজ করার জন্য প্রয়োজনীয় ধাপগুলি বর্ণনা করা হয়েছে:

Worldpay পেমেন্ট পরিষেবা প্রদানকারীর সাথে মার্চেন্ট অ্যাকাউন্ট সেট-আপ করা

শুরু করার আগে, আপনাকে অবশ্যই থার্ড-পার্টি পেমেন্ট প্রদানকারীর (Worldpay) সাথে যোগাযোগ করে আপনার মার্চেন্ট অ্যাকাউন্ট সেট-আপ করতে হবে। আপনাকে দুটি অ্যাকাউন্ট সেট-আপ করার জন্য সাজেস্ট করা হয়, একটি টেস্টিংয়ের জন্য এবং একটি প্রোডাকশনের জন্য। Worldpay মার্চেন্ট অ্যাকাউন্ট সম্পর্কে আরও তথ্যের জন্য, www.worldpay.com এবং wp-support.crm.worldpay.com (Worldpay সহায়তা কেন্দ্র) দেখুন।

আপনার মার্চেন্ট অ্যাকাউন্ট সেট-আপ করা হয়ে গেলে এবং অ্যাকাউন্টের ক্রেডেনশিয়াল পাওয়ার পরে, Worldpay-এর সাথে আপনার মার্চেন্ট অ্যাকাউন্ট কনফিগার করতে:

  1. https://secure.worldpay.com/sso/public/auth/login.html লিঙ্কে নেভিগেট করুন।
  2. Worldpay-এর দেওয়া ক্রেডেনশিয়াল ব্যবহার করে আপনার Worldpay অ্যাকাউন্টে লগ-ইন করুন।
  3. XML পাসওয়ার্ড ও মেসেজ যাচাইকারী কোড (MAC) সিক্রেট কী সেট করুন:
    1. প্রোফাইল বিকল্পে ক্লিক করুন।
    2. Edge-এ Worldpay পেমেন্ট পরিষেবা কনফিগার করার সময় ব্যবহার করার জন্য পাসওয়ার্ড সেট করুন XML পাসওয়ার্ড ফিল্ডে।
    3. Redirect MAC secret ফিল্ডে ২০ থেকে ৩০ অক্ষরের MAC সিক্রেট কী লিখুন।
    4. প্রোফাইল সেভ করুন বিকল্পে ক্লিক করুন
  4. মার্চেন্ট IP-এর তালিকায় Apigee Edge ম্যানেজমেন্ট সার্ভার যোগ করুন (হোয়াইটলিস্ট):
    1. প্রোফাইল > মার্চেন্ট এনভায়র্নমেন্ট বিকল্পে ক্লিক করুন।
    2. নতুন টেস্ট IP বিকল্পে ক্লিক করুন।
    3. Apigee Edge ম্যানেজমেন্ট সার্ভারের IP লিখুন।
    4. সেভ করুন বিকল্পে ক্লিক করুন।
  5. পদ্ধতি সহ Worldpay প্যারামিটার যোগ করতে মার্চেন্ট URL কনফিগার করুন যাচাইকরণ কোড (MAC):
    1. ইনস্টলেশন > হোস্ট করা পেমেন্ট পৃষ্ঠা > পেমেন্ট পৃষ্ঠা ডিজাইনার বিকল্পে ক্লিক করুন।
    2. পেমেন্ট পৃষ্ঠা এডিট করুন বিকল্পের মধ্যে, চ্যানেল বেছে নিন ড্রপ-ডাউন তালিকা থেকে আপনার ইনস্টলেশন আইডি বেছে নিন।
    3. প্রপার্টি ট্যাবে গিয়ে মার্চেন্ট কনফিগারেশন এডিট করুন বিকল্প বেছে নিন।
    4. Send URL প্যারামিটার ভ্যালু True হিসেবে সেট করুন।
    5. প্রকাশ করুন ট্যাবে ক্লিক করুন।
    6. নিম্নলিখিত পরিবর্তনগুলি প্রমোট করুন:
      • টেস্ট এনভায়রনমেন্টের জন্য, ডিজাইন বিকল্পের মধ্যে প্রোমোট করুন বিকল্পে ক্লিক করুন ডিজাইন থেকে স্যান্ডবক্সে প্রোমোট করতে।
      • প্রোডাকশন এনভায়রনমেন্টের জন্য, স্যান্ডবক্স থেকে প্রোডাকশনে প্রোমোট করতে, স্যান্ডবক্স-এর অধীনে প্রোমোট করুন বিকল্পে ক্লিক করুন।

Edge-এ পেমেন্ট পরিষেবা প্রদানকারীকে কনফিগার করা

পরবর্তী ধাপ হল Edge-এ পেমেন্ট পরিষেবা প্রদানকারীকে কনফিগার করা।

আপনি নিম্নলিখিত API ব্যবহার করে নির্দিষ্ট সংস্থার জন্য আপনার পেমেন্ট পরিষেবা প্রদানকারীকে কনফিগার করতে পারবেন:

/organizations/{org-name}/providers

শুধুমাত্র Apigee Edge Private Cloud গ্রাহকরাই সিস্টেম অ্যাডমিন প্রিভিলেজ সহ নিম্নলিখিত API ব্যবহার করে ঐচ্ছিকভাবে গ্লোবাল পেমেন্ট প্রদানকারী কনফিগার করতে পারবেন:

/config/providers

প্রতিটি API কল করার সময়, আপনাকে অবশ্যই অনুরোধের বডিতে নিম্নলিখিত তথ্য উল্লেখ করতে হবে:

প্যারামিটার বিবরণ আবশ্যক
authType পেমেন্ট পরিষেবা প্রদানকারীর দেওয়া ইনস্টলেশন আইডি। হ্যাঁ
credential আপনার Worldpay মার্চেন্ট অ্যাকাউন্টের জন্য Base64-এনকোড করা ক্রেডেনশিয়াল (username:XMLpassword); username হল মার্চেন্ট কোডের (সবকটি অক্ষর বড় হাতের) সমতুল্য এবং XMLpassword আপনার Worldpay মার্চেন্ট অ্যাকাউন্ট সেট-আপ করার সময় আগের ধাপে সেট করা XML পাসওয়ার্ড নির্দিষ্ট করে। হ্যাঁ
description পেমেন্ট প্রদানকারীর বিবরণ। না
endpoint পেমেন্ট পরিষেবা প্রদানকারীকে অ্যাক্সেস করার এন্ডপয়েন্ট
  • টেস্ট অ্যাকাউন্টের জন্য, এগুলি ব্যবহার করুন: https://secure-test.worldpay.com/jsp/merchant/xml/paymentService.jsp
  • প্রোডাকশন অ্যাকাউন্টের জন্য, এগুলি ব্যবহার করুন: https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp
হ্যাঁ
merchantCode API কনজিউমারকে পেমেন্ট প্রদানকারীর দেওয়া মার্চেন্ট কোড হ্যাঁ
name প্রদানকারীর জন্য ব্যবহার করার নাম।

শুধুমাত্র Apigee Edge প্রাইভেট ক্লাউড গ্রাহকদের জন্য: গ্লোবাল পেমেন্ট প্রোভাইডারদের ক্ষেত্রে, নিশ্চিত করুন যে সব Edge সংস্থা জুড়ে নাম অনন্য। সহজে শনাক্তকরণের জন্য পরিষেবা প্রদানকারীর নামে WorldPay (কেস-ইনসেনসিটিভ) অন্তর্ভুক্ত করার জন্য সাজেস্ট করা হয়। যেমন: WorldPay test বা WorldPay prod. প্রোভাইডারের নামের স্পেস আন্ডারস্কোরে পরিবর্তিত হবে।

হ্যাঁ

যেমন, নিম্নলিখিতটি Worldpay-myorg নামের Worldpay-এর সাথে একটি মার্চেন্ট অ্যাকাউন্ট সেট-আপ করে:

$ curl  -H "Content-Type:application/json" -X POST -d \
'{
    "name": "Worldpay-myorg",
    "description": "Worldpay payment provider",
    "endpoint": "https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "authType": "123456",
    "credential": "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "merchantCode": "myMerchantCode"
  }' \
"https://api.enterprise.apigee.com/v1/organizations/myOrg/providers" \
-u email:password 

থার্ড-পার্টি পেমেন্ট পরিষেবা প্রদানকারী দেখা

নিম্নলিখিত রিসোর্সে GET অনুরোধ ইস্যু করে আপনার Edge সংস্থার জন্য কনফিগার করা থার্ড-পার্টি পেমেন্ট প্রদানকারীকে দেখুন এবং কনফার্ম করুন:

/mint/organizations/{org-name}/providers

যেমন, নিম্নলিখিত তথ্য থেকে myorg-এর জন্য বর্তমানে কনফিগার করা থার্ড-পার্টি পেমেন্ট পরিষেবা প্রদানকারী সম্পর্কে জানা যায়:

$ curl  -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/providers" \
-u email:password

নিচে দেওয়া উত্তরে দুটি মার্চেন্ট অ্যাকাউন্ট দেখানো হয়েছে, একটি টেস্টিংয়ের জন্য এবং অন্যটি প্রোডাকশনের জন্য।

{
  "provider" : [ {
    "authType" : "123456",
    "credential" : "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "description" : "Worldpay payment provider",
    "endpoint" : "https://secure.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "id" : "worldpay-myorg",
    "merchantCode" : "MERCH_CODE",
    "name" : "Worldpay-myorg"
  }, {
    "authType" : "123456",
    "credential" : "dXNlcm5hbWU6cGFzc3dvcmQ=",
    "description" : "Worldpay payment provider",
    "endpoint" : "https://secure-test.worldpay.com/jsp/merchant/xml/paymentService.jsp",
    "id" : "worldpay-test",
    "merchantCode" : "MERCH_CODE_FROM_PROVIDER",
    "name" : "Worldpay-test"
  } ]
}

ডেভেলপার পোর্টালে মনিটাইজেশন ও Worldpay মডিউল চালু ও কনফিগার করা

ডেভেলপার পোর্টালে প্রয়োজনীয় মনিটাইজেশন ও Worldpay মডিউল চালু করুন। আরও তথ্যের জন্য, ডেভেলপার পোর্টালে মনিটাইজেশন কনফিগার করুন বিকল্প দেখুন।

পেমেন্ট পরিষেবা প্রদানকারী ব্যবহার করে প্রিপেড অ্যাকাউন্টে পেমেন্ট শুরু করা

প্রিপেড অ্যাকাউন্ট ম্যানেজমেন্ট ফ্লোয়ের ২ নম্বর ধাপে দেখানো হয়েছে যে, API কনজিউমাররা যখন: পেমেন্ট পরিষেবা প্রদানকারী ব্যবহার করে প্রিপেড অ্যাকাউন্টে পেমেন্ট করেন, তখন ডেভেলপার পোর্টাল তা শুরু করে।

  • রেট প্ল্যান গ্রহণ করেছেন, কিন্তু তার প্রিপেড অ্যাকাউন্টে পর্যাপ্ত ব্যালেন্স নেই
  • তার প্রিপেড অ্যাকাউন্টে টাকা যোগ করার অনুরোধ।

API ব্যবহার করে থার্ড-পার্টি পেমেন্ট প্রদানকারীর থেকে পেমেন্ট শুরু করতে, নিম্নলিখিত রিসোর্সে একটি POST অনুরোধ ইস্যু করুন, যেখানে {developer_id} হল ডেভেলপারের ইমেল আইডি।

/mint/organizations/{org_name}/developers/{developer_id}/payment?amount={amount}&provider={providerId}&supportedCurrencyId={currency}

আপনি অনুরোধ করার সময়, কোয়েরি প্যারামিটার হিসেবে আপনাকে নিম্নলিখিত ভ্যালু উল্লেখ করতে হবে:

  • প্রিপেড অ্যাকাউন্টের ব্যালেন্সে যোগ করার পরিমাণ (amount={amount})
  • পেমেন্ট পরিষেবা প্রদানকারীর আইডি (provider={providerId})
  • কাজ করে এমন মুদ্রা (supportedCurrencyId={currency})

এছাড়াও, আপনাকে কোম্পানির বিলিং অ্যাড্রেসের মতো অ্যাকাউন্টের প্রাথমিক বিবরণ দিতে হবে।

যেমন, নিম্নলিখিতটি Worldpay পেমেন্ট পরিষেবা প্রদানকারী ব্যবহার করে একটি প্রি-পেড অ্যাকাউন্টের ব্যালেন্স রিলোড করে। আপনার প্রিপেড অ্যাকাউন্টে প্রাথমিক ট্রান্সফার হবে ১০ মার্কিন ডলার (amount কোয়েরি প্যারামিটার 10 হিসেবে সেট করা আছে)।

$ curl  -H "Content-Type:application/xml" -X POST -d \
'{
    "address1": "5115 Hopyard Ave.",
    "city": "Pleasanton",
    "country": "US",
    "state": "CA",
    "zip": "58158"
}'
' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/payment?amount=10&provider=worldpay-myorg&supportedCurrencyId=usd" \
-u email:password

উত্তরের একটি উদাহরণ নিচে দেওয়া হল:

{
    "isRecurring": "false",
    "orderCode": "1234",
    "referenceId": "3042815493",
    "referenceUrl": "https://secure.worldpay.com/wcc/dispatcher?OrderKey=MERCH_CODE_FROM_PROVIDER%5E1234",
    "success": "true"
}

Worldpay-এর সুরক্ষিত পেমেন্ট পৃষ্ঠার URL referenceUrl-এ ফেরত পাঠানো হয় এবং এর সাথে আপনার অনন্য অর্ডার কী কোয়েরি প্যারামিটার হিসেবে যোগ করা থাকে।

API ব্যবহার করে প্রিপেড অ্যাকাউন্টের ব্যালেন্স আবার লোড করা

প্রিপেড অ্যাকাউন্ট ম্যানেজমেন্ট ফ্লোয়ের ১৫ নম্বর ধাপে দেখানো হয়েছে যে পেমেন্ট প্রদানকারী সফলভাবে প্রসেস করার বিষয়টি যাচাই করার পরে, ডেভেলপার পোর্টাল Edge-কে প্রিপেড অ্যাকাউন্ট আবার লোড করার অনুরোধ পাঠায়।

আপনি ডেভেলপার বা কোম্পানির জন্য API ব্যবহার করে প্রিপেড অ্যাকাউন্টের ব্যালেন্স আবার লোড করতে পারবেন, যেমন নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে।

কোনও ডেভেলপারের জন্য প্রিপেড অ্যাকাউন্ট ব্যালেন্স আবার লোড করা

API ব্যবহার করে কোনও ডেভেলপারের জন্য প্রিপেড অ্যাকাউন্টের ব্যালেন্স আবার লোড করতে, /mint/organizations/{org_name}/developers/{developer_id}/developer-balances-এ একটি POST অনুরোধ ইস্যু করুন, যেখানে {developer_id} হল ডেভেলপারের ইমেল আইডি। আপনি অনুরোধ করার সময়, আপনাকে অনুরোধের বডিতে ব্যালেন্সে যোগ করার পরিমাণ ও ব্যবহৃত মুদ্রা উল্লেখ করতে হবে।

যেমন, নিম্নলিখিত অনুরোধটি কোনও ডেভেলপারের প্রিপেড অ্যাকাউন্টের ব্যালেন্সে $১০০০ যোগ করে:

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "amount": 1000,
  "supportedCurrency": {
      "id": "usd" 
  } 
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password

অনুরোধের প্রপার্টির বিবরণ পেতে, প্রিপেড অ্যাকাউন্ট রিলোড করার জন্য অনুরোধের প্রপার্টির সারসংক্ষেপ দেখুন।

কোনও কোম্পানির জন্য প্রিপেড অ্যাকাউন্টের ব্যালেন্স আবার লোড করা

API ব্যবহার করে কোনও কোম্পানির জন্য প্রিপেড অ্যাকাউন্টের ব্যালেন্স আবার লোড করতে, /mint/organizations/{org_name}/companies/{company_id}/developer-balances-এ একটি POST অনুরোধ ইস্যু করুন, যেখানে {company_id} হল কোম্পানির আইডি। আপনি অনুরোধ করার সময়, আপনাকে অনুরোধের বডিতে ব্যালেন্সে যোগ করার পরিমাণ ও ব্যবহৃত মুদ্রা উল্লেখ করতে হবে।

যেমন, নিম্নলিখিত অনুরোধটি কোনও কোম্পানির প্রিপেড অ্যাকাউন্ট ব্যালেন্সে $১০০০ যোগ করে:

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "amount": 1000,
  "supportedCurrency": {
      "id": "usd" 
  } 
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password

অনুরোধের প্রপার্টির বিবরণ পেতে, প্রিপেড অ্যাকাউন্ট রিলোড করার জন্য অনুরোধের প্রপার্টির সারসংক্ষেপ দেখুন।

প্রিপেড অ্যাকাউন্ট রিলোড করার জন্য অনুরোধের প্রপার্টির সংক্ষিপ্তসার

API ব্যবহার করে প্রিপেড অ্যাকাউন্টের ব্যালেন্স আবার লোড করার সময় নিম্নলিখিত প্রপার্টি উল্লেখ করতে হবে: API:

নাম বিবরণ ডিফল্ট প্রয়োজনীয়?
amount

প্রিপেড ব্যালেন্সে প্রয়োগ করা পরিমাণ (প্রযোজ্য মুদ্রায়)।

প্রযোজ্য নয় হ্যাঁ
supportedCurrency

প্রিপেড ব্যালেন্সের জন্য ব্যবহৃত মুদ্রা। ডেভেলপার যে API প্যাকেজ কিনেছেন সেটির প্ল্যানের জন্য এই মুদ্রা সেট-আপ করা হয়েছে।

প্রযোজ্য নয় হ্যাঁ

থার্ড-পার্টি পেমেন্ট পরিষেবা প্রদানকারীকে মুছে দেওয়া

আপনি Edge সংস্থার জন্য কনফিগার করা থার্ড-পার্টি পেমেন্ট প্রদানকারীকে নিম্নলিখিত রিসোর্সে একটি মুছে ফেলার অনুরোধ পাঠিয়ে মুছে দিতে পারেন:

নির্দিষ্ট সংস্থার জন্য পেমেন্ট পরিষেবা প্রদানকারীকে মুছে দিতে, নিম্নলিখিত API ব্যবহার করুন:

/mint/organizations/{org-name}/providers/id

শুধুমাত্র Apigee Edge প্রাইভেট ক্লাউড গ্রাহকরা সিস্টেম অ্যাডমিন বিশেষ সুবিধা সহ নিম্নলিখিত API ব্যবহার করে ঐচ্ছিকভাবে গ্লোবাল পেমেন্ট প্রদানকারীকে মুছে দিতে পারেন:

/config/providers/id

যেমন, নিম্নলিখিত কমান্ডটি myorg-এর জন্য বর্তমানে কনফিগার করা থার্ড-পার্টি পেমেন্ট প্রদানকারীকে মুছে দেয়:

$ curl  -X DELETE \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/providers/worldpay-myorg" \
-u email:password

ম্যানুয়ালি প্রিপেড অ্যাকাউন্টের ব্যালেন্স ম্যানেজ করা

বিকল্প হিসেবে, আপনি ম্যানুয়ালি পেমেন্ট ট্র্যাক করে বা ইন্টিগ্রেটেড বিলিং সিস্টেমের মাধ্যমে প্রিপেড ব্যালেন্স রিলোড করা ম্যানেজ করতে পারেন এবং তারপর অ্যাকাউন্ট রিলোড করার জন্য মনিটাইজেশন API কল করতে পারেন, যেমন API ব্যবহার করে প্রিপেড অ্যাকাউন্ট ব্যালেন্স রিলোড করা নিবন্ধে বর্ণনা করা হয়েছে।

API ব্যবহার করে প্রিপেড অ্যাকাউন্টের ব্যালেন্স অটোমেটিক রিলোড করার সুবিধা সেট-আপ করা

থার্ড-পার্টি পেমেন্ট পরিষেবা প্রদানকারী ব্যবহার করে কোনও ডেভেলপার বা কোম্পানির জন্য প্রিপেড অ্যাকাউন্ট ব্যালেন্স কীভাবে অটোমেটিক রিফিল সেট-আপ করতে হয় তা নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে। রেট প্ল্যানের জন্য রেকারিং পেমেন্ট ম্যানেজ করতে এই বিকল্পটি কাজে লাগে।

ডেভেলপারের জন্য প্রিপেড অ্যাকাউন্ট ব্যালেন্স অটোমেটিক রিলোড করার সুবিধা সেট-আপ করা

ব্যালেন্স একটি নির্দিষ্ট থ্রেশহোল্ডের নিচে নেমে গেলে ডেভেলপারের প্রিপেড অ্যাকাউন্টের ব্যালেন্স অটোমেটিক রিলোড করার সুবিধা সেট-আপ করতে, /mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup-এ একটি POST অনুরোধ ইস্যু করুন, যেখানে {developer_id} হল ডেভেলপারের ইমেল আইডি।

অনুরোধ করার সময়, আপনাকে নিম্নলিখিত বিষয়গুলি নির্দিষ্ট করতে হবে:

  • অ্যাকাউন্ট রিলোড করার জন্য ব্যবহার করা পেমেন্ট পরিষেবা প্রদানকারীর আইডি (providerID)
  • অটোমেটিক রিলোড করার সুবিধা চালু করে এমন ফ্ল্যাগ (isRecurring)
  • অটোমেটিক রিলোড (replenishAmount) ট্রিগার করার জন্য প্রিপেড অ্যাকাউন্টের ব্যালেন্স যে থ্রেশহোল্ডের নিচে নামতে হবে
  • অ্যাকাউন্টে অটোমেটিক যোগ করার পরিমাণ (recurringAmount)
  • মুদ্রা নির্দিষ্ট করতে supportedCurrencyID কোয়েরি প্যারামিটার।

নিম্নলিখিত উদাহরণে, ডেভেলপারের প্রিপেড অ্যাকাউন্টের ব্যালেন্স ৫ মার্কিন ডলারের নিচে নেমে গেলে, অ্যাকাউন্টে অতিরিক্ত ১০ মার্কিন ডলার অটোমেটিক যোগ করা হবে।

$ curl -H "Content-Type:application/json" -X POST -d \
'{
    "providerId": "worldpay-myorg",
    "isRecurring" : true,
    "replenishAmount" : 5,
    "recurringAmount" : 10
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances/recurring-setup?supportedCurrencyId=usd" \
-u email:password

অনুরোধের প্রপার্টির বিবরণ পেতে, প্রিপেড অ্যাকাউন্টে অটোমেটিক রিলোড সেট-আপ করার জন্য অনুরোধের প্রপার্টির সারসংক্ষেপ দেখুন।

কোনও কোম্পানির জন্য প্রিপেড অ্যাকাউন্টের ব্যালেন্স অটোমেটিক রিলোড করার সুবিধা সেট-আপ করা

কোনও কোম্পানির প্রিপেড অ্যাকাউন্টের ব্যালেন্স একটি নির্দিষ্ট পরিমাণের নিচে নেমে গেলে, অটোমেটিক রিলোড করার সুবিধা সেট-আপ করতে, /mint/organizations/{org_name}/companies/{company_id}/developer-balances/recurring-setup-এ POST অনুরোধ ইস্যু করুন, যেখানে {company_id} হল কোম্পানির আইডি।

অনুরোধ করার সময়, আপনাকে নিম্নলিখিত বিষয়গুলি নির্দিষ্ট করতে হবে:

  • অ্যাকাউন্ট রিলোড করার জন্য ব্যবহার করা পেমেন্ট পরিষেবা প্রদানকারীর আইডি (providerID)
  • অটোমেটিক রিলোড করার সুবিধা চালু করে এমন ফ্ল্যাগ (isRecurring)
  • অটোমেটিক রিলোড (replenishAmount) ট্রিগার করার জন্য প্রিপেড অ্যাকাউন্টের ব্যালেন্স যে থ্রেশহোল্ডের নিচে নামতে হবে
  • অ্যাকাউন্টে অটোমেটিক যোগ করার পরিমাণ (recurringAmount)
  • মুদ্রা নির্দিষ্ট করতে supportedCurrencyID কোয়েরি প্যারামিটার।

নিচের উদাহরণে, কোম্পানির প্রিপেড অ্যাকাউন্টের ব্যালেন্স ৫ মার্কিন ডলারের নিচে নেমে গেলে, অ্যাকাউন্টে অতিরিক্ত ১০ মার্কিন ডলার অটোমেটিক যোগ হয়ে যাবে।

$ curl -H "Content-Type:application/json" -X POST -d \
'{
    "providerId": "worldpay-myorg",
    "isRecurring" : true,
    "replenishAmount" : 5,
    "recurringAmount" : 10
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances/recurring-setup?supportedCurrencyId=usd" \
-u email:password

অনুরোধের প্রপার্টির বিবরণ পেতে, প্রিপেড অ্যাকাউন্টে অটোমেটিক রিলোড সেট-আপ করার জন্য অনুরোধের প্রপার্টির সারসংক্ষেপ দেখুন।

প্রিপেড অ্যাকাউন্টে অটোমেটিক রিলোড সেট-আপ করার জন্য অনুরোধের প্রপার্টির সারসংক্ষেপ

API ব্যবহার করে প্রিপেড অ্যাকাউন্টের ব্যালেন্স অটোমেটিক রিলোড করার সময় নিম্নলিখিত অ্যাট্রিবিউট নির্দিষ্ট করা যেতে পারে ।

নাম বিবরণ ডিফল্ট প্রয়োজনীয়?
providerId

পেমেন্ট পরিষেবা প্রদানকারীর আইডি।

প্রযোজ্য নয় হ্যাঁ
chargePerUsage মিথ্যা না
isRecurring

অটোমেটিক রিলোড চালু (true) আছে কিনা তা নির্দিষ্ট করে এমন ফ্ল্যাগ। অটোমেটিক রিলোড বন্ধ করতে, এই ফ্ল্যাগটি false হিসেবে সেট করুন।

প্রযোজ্য নয় হ্যাঁ
replenishAmount

অটোমেটিক রিলোড ট্রিগার করার জন্য প্রিপেড অ্যাকাউন্টের ব্যালেন্সকে এই থ্রেশহোল্ডের নিচে নামতে হবে।

প্রযোজ্য নয় হ্যাঁ
recurringAmount

অটোমেটিক রিলোড ট্রিগার হলে প্রিপেড অ্যাকাউন্টে যোগ করার পরিমাণ।

প্রযোজ্য নয় হ্যাঁ

WorldPay-এর হোস্ট করা পেমেন্ট পৃষ্ঠায় মাইগ্রেট করা

WorldPay তাদের নিরাপদ পেমেন্ট প্রসেসিং ফ্লো আপডেট করেছে যাতে নতুন সেট পৃষ্ঠা ব্যবহার করা যায়, এগুলিকে হোস্টেড পেমেন্ট পৃষ্ঠা বলা হয়।

আপনি যদি WorldPay পেমেন্ট পরিষেবা প্রদানকারীকে পুরানো নিরাপদ পেমেন্ট প্রসেসিং ফ্লো (আগস্ট ২০১৭-এর আগে) ব্যবহার করে কনফিগার করে থাকেন, তাহলে আপনাকে জানুয়ারি ২০১৮-এর আগে WorldPay-এর নতুন হোস্ট করা পেমেন্ট পেজে মাইগ্রেট করতে হবে।

WorldPay-এর হোস্ট করা পেমেন্ট পৃষ্ঠায় মাইগ্রেট করতে:

  1. নতুন হোস্টেড পেমেন্ট পৃষ্ঠা ব্যবহার করতে আপনার বর্তমান অ্যাকাউন্ট মাইগ্রেট করতে WorldPay-এর সাথে যোগাযোগ করুন এবং আপনার অ্যাকাউন্টের জন্য একটি নতুন ইনস্টলেশন আইডি পান।
  2. Edge-এ পেমেন্ট পরিষেবা প্রদানকারী কনফিগার করা নিবন্ধে বর্ণিত পদ্ধতিতে নতুন WorldPay পেমেন্ট পরিষেবা প্রদানকারী কনফিগার করুন এবং authType ফিল্ডে ইনস্টলেশন আইডি পাস করুন।
  3. ডেভেলপার পোর্টালে মনিটাইজেশন কনফিগার করুন নিবন্ধে যেভাবে বর্ণনা করা হয়েছে, সেইভাবে আপনার ডেভেলপার পোর্টালে নতুন পেমেন্ট পরিষেবা প্রদানকারীকে কনফিগার করুন।
  4. আপনি যদি পেমেন্ট পরিষেবা প্রদানকারীর মাধ্যমে প্রিপেড অ্যাকাউন্টের অটোমেটিক রিলোড সেট-আপ করেন, তাহলে আপনাকে API ব্যবহার করে প্রিপেড অ্যাকাউন্ট ব্যালেন্সের অটোমেটিক রিলোড সেট-আপ করা নিবন্ধে বর্ণিত নতুন প্রদানকারী আইডি ব্যবহার করার জন্য অটোমেটিক রিলোড আবার কনফিগার করতে হবে।

পরবর্তী ধাপ

আপনি স্বতন্ত্র পোস্টপেইড ডেভেলপারদের জন্য ক্রেডিট সীমা সেট করতে পারবেন। পোস্টপেড ব্যালেন্স ম্যানেজ করা থেকে কীভাবে তা জানুন।