- HTTP অনুরোধ
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- রেমিট্যান্স স্টেটমেন্ট সারসংক্ষেপ
- বিলিং সময়ের
- রেমিটেন্স নির্দেশাবলী
- ঘটনা
একটি রেমিট্যান্স বিবৃতি সম্পর্কে লেনদেনের বিস্তারিত তথ্য প্রদান করে।
এটি একটি পেজিনেটেড API। প্রতি পৃষ্ঠায় লেনদেনের ইভেন্টের সংখ্যা numberOfEvents
দিয়ে নির্দিষ্ট করা যেতে পারে। অনির্দিষ্ট থাকলে, প্রতি পৃষ্ঠায় সর্বাধিক 1000টি ইভেন্ট ফেরত দেওয়া হবে। এই API-এর প্রতিটি অনুরোধ বিবৃতিতে পরবর্তী লেনদেনের ইভেন্টের সাথে সাথে বিবৃতিতে মোট লেনদেনের সংখ্যা নির্দিষ্ট করে মোট totalEvents
নির্দেশ করে একটি nextEventOffset
ফেরত দেবে। যদি বর্তমান পুনরুদ্ধার করা পৃষ্ঠায় বিবৃতির শেষ লেনদেন থাকে, তাহলে nextEventOffset
প্রতিক্রিয়াতে উপস্থিত থাকবে না।
statementId
মান হল remittanceStatementNotificationRequest
থেকে প্রাপ্ত requestId
অনুরোধটি প্রক্রিয়া করার সময় যদি এন্ডপয়েন্ট কোনো ত্রুটির সম্মুখীন হয়, তাহলে এই এন্ডপয়েন্ট থেকে পাওয়া প্রতিক্রিয়া হবে
টাইপ।ErrorResponse
যদি এই পদ্ধতিটি HTTP 200 ফেরত না দেয় তবে এই প্রশ্নের উত্তরগুলি খালি হতে পারে৷ প্রতিক্রিয়ার অংশটি এমন পরিস্থিতিতে খালি থাকে যেখানে একটি স্পষ্ট বিবরণ সহ একটি
আক্রমণকারীকে অন্যান্য ইন্টিগ্রেটরের পেমেন্ট ইন্টিগ্রেটর অ্যাকাউন্ট শনাক্তকারী বুঝতে সাহায্য করতে ব্যবহার করা যেতে পারে৷ এই পরিস্থিতিতে, যেখানে হয় সাইনিং কী মেলে না, পেমেন্ট ইন্টিগ্রেটর শনাক্তকারী পাওয়া যায়নি, বা এনক্রিপশন কী অজানা ছিল, এই পদ্ধতিটি একটি খালি বডি সহ HTTP 404 ফিরিয়ে দেবে। যদি অনুরোধ স্বাক্ষর যাচাই করা যায়, ত্রুটি সংক্রান্ত অতিরিক্ত তথ্য প্রতিক্রিয়া বডিতে ফেরত দেওয়া হবে।ErrorResponse
একটি উদাহরণ অনুরোধ এর মত দেখায়:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 0,
"revision": 0
},
"requestId": "statement_detail_request_139932019",
"requestTimestamp": "1502551332087"
},
"paymentIntegratorAccountId": "InvisiCashUSA_USD",
"statementId": "0123434-statement-abc",
"numberOfEvents": 4
}
একটি উদাহরণ প্রতিক্রিয়া মত দেখায়:
{
"responseHeader": {
"responseTimestamp": "1481900013178"
},
"eventOffset": 0,
"nextEventOffset": 4,
"totalEvents": 15,
"remittanceStatementSummary": {
"statementDate": "1502521200000",
"billingPeriod": {
"startDate": "1502434800000",
"endDate": "1502434800000"
},
"dateDue": "1502348400000",
"currencyCode": "INR",
"totalDueByIntegrator": "1076000000",
"remittanceInstructions": {
"memoLineId": "stmt-1AB-pp0-invisi"
}
},
"captureEvents": [
{
"eventRequestId": "bWVyY2hhbnQgdHJhbnNhY3Rpb24gaWQ",
"paymentIntegratorEventId": "ioj32SOIjf23oijSDfoij",
"eventCharge": "700000000",
"eventFee": "-28000000"
},
{
"eventRequestId": "Ggghvh78200PQ3Yrpb",
"paymentIntegratorEventId": "iasdf23dSdfijSDfoij",
"eventCharge": "800000000",
"eventFee": "-32000000"
}
],
"refundEvents": [
{
"eventRequestId": "liUrreQY233839dfFFb24gaQM",
"paymentIntegratorEventId": "asd3SDf3f3oijSDfoij",
"eventCharge": "-200000000",
"eventFee": "8000000"
},
{
"eventRequestId": "IIghhhUrreQY233839II9qM==",
"paymentIntegratorEventId": "DFjidoso12FSDFSDE",
"eventCharge": "-150000000",
"eventFee": "6000000"
}
]
}
HTTP অনুরোধ
POST https://vgw.googleapis.com/secure-serving/gsp/v1/remittanceStatementDetails/ :PIAID
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব |
---|
{
"requestHeader": {
object ( |
ক্ষেত্র | |
---|---|
requestHeader | প্রয়োজনীয় : সমস্ত অনুরোধের জন্য সাধারণ শিরোনাম। |
paymentIntegratorAccountId | প্রয়োজনীয় : এটি হল পেমেন্ট ইন্টিগ্রেটর অ্যাকাউন্ট আইডেন্টিফায়ার যা এই স্টেটমেন্টের চারপাশে চুক্তির সীমাবদ্ধতা চিহ্নিত করে। |
statementId | প্রয়োজনীয় : বিবৃতি বিজ্ঞপ্তির অনুরোধ আইডি। |
eventOffset | ঐচ্ছিক : এই অফসেট থেকে শুরু হওয়া ইভেন্টগুলি ফেরত দিন৷ এটিকে |
numberOfEvents | ঐচ্ছিক : প্রতি পৃষ্ঠায় দেখানোর জন্য ইভেন্টের সংখ্যা। অনির্দিষ্ট বা 1000 এর বেশি হলে, এটি 1000 হবে। |
প্রতিক্রিয়া শরীর
রেমিটেন্স বিবৃতি বিস্তারিত পদ্ধতির জন্য প্রতিক্রিয়া বস্তু.
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
JSON প্রতিনিধিত্ব |
---|
{ "responseHeader": { object ( |
ক্ষেত্র | |
---|---|
responseHeader | প্রয়োজনীয় : সমস্ত প্রতিক্রিয়ার জন্য সাধারণ শিরোনাম। |
remittanceStatementSummary | প্রয়োজনীয় : এই রেমিটেন্স স্টেটমেন্টের সারাংশ। |
eventOffset | প্রয়োজনীয় : এই প্রতিক্রিয়ার ইভেন্ট অফসেট। |
nextEventOffset | ঐচ্ছিক : ফেরার জন্য পরবর্তী ইভেন্টের অফসেট। অনির্দিষ্ট থাকলে এই বিবৃতিটি পুনরুদ্ধার করার জন্য আর কোন ইভেন্ট নেই। |
totalEvents | প্রয়োজনীয় : এই বিবৃতিতে ইভেন্টের মোট সংখ্যা। |
totalWithholdingTaxes | প্রয়োজনীয় : এই বিবৃতিটির জন্য আটকে রাখা সমস্ত করের সমষ্টি৷ এই মানটি মাইক্রোতে রয়েছে। |
captureEvents[] | প্রয়োজনীয় : ক্যাপচার ইভেন্টের সেট। |
refundEvents[] | প্রয়োজনীয় : রিফান্ড ইভেন্টের সেট। |
reverseRefundEvents[] | ঐচ্ছিক : রিভার্স রিফান্ড ইভেন্টের সেট। |
chargebackEvents[] | ঐচ্ছিক : চার্জব্যাক ইভেন্টের সেট। |
reverseChargebackEvents[] | ঐচ্ছিক : বিপরীত চার্জব্যাক ইভেন্টের সেট। |
adjustmentEvents[] | ঐচ্ছিক : সমন্বয় ইভেন্টের সেট। বিলিং বৈষম্যগুলি মিটমাট করার জন্য Google-এর বিবেচনার ভিত্তিতে সামঞ্জস্য ইভেন্টগুলি যোগ করা যেতে পারে, উদাহরণস্বরূপ যদি পূর্বের লেনদেনের একটি সেটের জন্য ফি কম গণনা করা হয়, তাহলে একটি সমন্বয়কে সম্পূর্ণরূপে সংহত করতে ব্যবহার করা যেতে পারে৷ |
রেমিট্যান্স স্টেটমেন্ট সারসংক্ষেপ
একটি রেমিটেন্স বিবৃতি সম্পর্কে সারাংশ বস্তু.
JSON প্রতিনিধিত্ব |
---|
{ "statementDate": string, "billingPeriod": { object ( |
ক্ষেত্র | |
---|---|
statementDate | প্রয়োজনীয় : তারিখ (আমেরিকা/লস এঞ্জেলেসে) যে এই বিবৃতিটি তৈরি করা হয়েছিল৷ |
billingPeriod | প্রয়োজনীয় : বিলিং সময়কাল এই বিবৃতিটি কভার করে। |
dateDue | ঐচ্ছিক : যে তারিখে রেমিট্যান্স জমা হবে। এটি যুগ থেকে মিলিসেকেন্ড হিসাবে উপস্থাপিত হয়। এটি একটি তারিখ (এবং তাই বিলিং টাইমজোনে সর্বদা দিনের প্রথম মিলিসেকেন্ডে শুরু হবে)। এটি সেট করা হয় যতক্ষণ না |
currencyCode | প্রয়োজনীয় : ISO 4217 3-অক্ষরের মুদ্রা কোড। |
totalDueByIntegrator | প্রয়োজনীয় : এই মানটি |
remittanceInstructions | প্রয়োজনীয় : কিভাবে পেমেন্ট পাঠাতে হয় তার বিশদ বিবরণ |
বিলিং সময়ের
এই বিবৃতি বিলিং সময়কাল.
JSON প্রতিনিধিত্ব |
---|
{ "startDate": string, "endDate": string } |
ক্ষেত্র | |
---|---|
startDate | প্রয়োজনীয় : বিলিং সময়ের শুরুর তারিখ। এটি যুগ থেকে মিলিসেকেন্ড হিসাবে উপস্থাপিত হয়। এটি একটি তারিখ (এবং তাই বিলিং টাইমজোনে সর্বদা দিনের প্রথম মিলিসেকেন্ডে শুরু হবে)। এটি বিলিং সময়ের দিনের প্রথম মিলিসেকেন্ড, 00:00:00.000 |
endDate | প্রয়োজনীয় : বিলিং সময়ের শেষ তারিখ। এটি যুগ থেকে মিলিসেকেন্ড হিসাবে উপস্থাপিত হয়। এটি বিলিং সময়ের শেষ দিনের শেষ মিলিসেকেন্ড, 23:59:59.999 |
রেমিটেন্স নির্দেশাবলী
এই রেমিট্যান্স বিজ্ঞপ্তি কিভাবে পরিশোধ করতে হবে সে সম্পর্কে তথ্য ধারণ করা কাঠামো।
JSON প্রতিনিধিত্ব |
---|
{ "memoLineId": string } |
ক্ষেত্র | |
---|---|
memoLineId | প্রয়োজনীয় : রেমিট্যান্স সনাক্তকরণের জন্য অর্থপ্রদানের জন্য মেমো লাইনে থাকা বাধ্যতামূলক শনাক্তকারী। |
ঘটনা
একটি রেমিটেন্স বিবৃতিতে অন্তর্ভুক্ত একটি একক ইভেন্টের প্রতিনিধিত্বকারী কাঠামো।
JSON প্রতিনিধিত্ব |
---|
{ "eventRequestId": string, "paymentIntegratorEventId": string, "eventCharge": string, "eventFee": string, "presentmentChargeAmount": string, "presentmentCurrencyCode": string, "exchangeRate": string, "nanoExchangeRate": string } |
ক্ষেত্র | |
---|---|
eventRequestId | প্রয়োজনীয় : ক্যাপচার বা রিফান্ড ইভেন্টের জন্য, Google অনুরোধের সাথে যে |
paymentIntegratorEventId | প্রয়োজনীয় : এই ইভেন্টের জন্য ফেরত পেমেন্ট ইন্টিগ্রেটর আইডি। একটি ক্যাপচারের জন্য এটি হল একটি এই ক্ষেত্রটি পরিবর্তনশীল দৈর্ঘ্যের, একটি ইন্টিগ্রেটর হিসাবে আপনি এই ইভেন্টের জন্য যে আইডি সরবরাহ করবেন তা এখানে প্রতিফলিত হবে। যদি সংশ্লিষ্ট ইভেন্টের জন্য ইন্টিগ্রেটর দ্বারা একটি মান প্রদান করা না হয়, তাহলে এই ক্ষেত্রটিতে রিভার্স রিফান্ড, চার্জব্যাক এবং রিভার্স চার্জব্যাক ইভেন্টের জন্য এটি সেই এই ক্ষেত্রের দৈর্ঘ্য এবং বিন্যাস প্রতিটি আইডির জন্য উৎস ক্ষেত্রের উপর নির্ভর করে। দৈর্ঘ্য এবং অক্ষর সেটের প্রয়োজনীয়তা সম্পর্কে বিশদ বিবরণের জন্য প্রতিটি উৎস ক্ষেত্রের জন্য ডকুমেন্টেশন পড়ুন। বিশেষ করে, মনে রাখবেন যে এই ক্ষেত্রটিতে কখনও কখনও Google-জেনারেট করা আইডি থাকতে পারে যার মধ্যে ইন্টিগ্রেটর-জেনারেটেড আইডিগুলির চেয়ে আলাদা সর্বোচ্চ দৈর্ঘ্যের প্রয়োজনীয়তা থাকতে পারে। |
eventCharge | প্রয়োজনীয় : বিবৃতি দ্বারা সংজ্ঞায়িত মুদ্রা কোডে। যদি এই মানটি ঋণাত্মক হয় তবে এটি Google থেকে পেমেন্ট ইন্টিগ্রেটরে চলে যাওয়া আর্থিক মূল্যকে উপস্থাপন করে। যদি এটি ইতিবাচক হয় তবে এটি Google-এর কারণে পেমেন্ট ইন্টিগ্রেটরের কাছ থেকে অর্থ। উদাহরণস্বরূপ, ক্যাপচার লেনদেন সবসময় ইতিবাচক হবে, এবং ফেরত লেনদেন সবসময় নেতিবাচক হবে। রিভার্স রিফান্ড এবং রিভার্স চার্জব্যাক ইভেন্ট সবসময় ইতিবাচক হবে। চার্জব্যাক ইভেন্ট সবসময় নেতিবাচক হবে. এই মানটি মাইক্রোতে রয়েছে। |
eventFee | প্রয়োজনীয় : বিবৃতি দ্বারা সংজ্ঞায়িত মুদ্রা কোডে। যদি এই মানটি ঋণাত্মক হয় তবে এটি Google থেকে পেমেন্ট ইন্টিগ্রেটরে চলে যাওয়া আর্থিক মূল্যকে উপস্থাপন করে। যদি এটি ইতিবাচক হয় তবে এটি Google-এর কারণে পেমেন্ট ইন্টিগ্রেটরের কাছ থেকে অর্থ। উদাহরণস্বরূপ, যদি একটি চুক্তি বলে যে Google পেমেন্ট ইন্টিগ্রেটরকে এই মানটি মাইক্রোতে রয়েছে। |
presentmentChargeAmount | ঐচ্ছিক : বৈদেশিক মুদ্রার আগে উপস্থাপনা (ওরফে লেনদেন) মুদ্রায় লেনদেনের পরিমাণ। এই ক্ষেত্রটি এই মানটি মাইক্রোতে রয়েছে। |
presentmentCurrencyCode | ঐচ্ছিক : আইএসও 4217 3-অক্ষরের মুদ্রা কোড যা উপস্থাপনা (লেনদেন) মুদ্রাকে চিহ্নিত করে। |
exchangeRate | ঐচ্ছিক : উপস্থাপনের পরিমাণকে নিষ্পত্তি (চালান) পরিমাণে রূপান্তর করতে ব্যবহৃত বিনিময় হার। এই মানটি মাইক্রো বেসিস পয়েন্টে (1 বেসিস পয়েন্ট = .0001 = .01%)। অর্থাৎ, বিনিময় হার পেতে, এই ক্ষেত্রটিকে 10^10 দ্বারা ভাগ করুন। |
nanoExchangeRate | ঐচ্ছিক : ন্যানো বেসিস পয়েন্টে প্রকাশ করা, সেটেলমেন্ট (ইনভয়েস) পরিমাণে উপস্থাপনের পরিমাণ রূপান্তর করতে ব্যবহৃত বিনিময় হার। এই মানটি ন্যানো বেসিস পয়েন্টে (1 বেসিস পয়েন্ট = .0001 = .01%)। অর্থাৎ, বিনিময় হার পেতে, এই ক্ষেত্রটিকে 10^13 দ্বারা ভাগ করুন। এই ক্ষেত্র এবং বিনিময় হার উভয়ই জনবহুল হবে। এগুলি বিভিন্ন নির্ভুলতার সাথে প্রকাশ করা সমতুল্য বিনিময় হার। ভবিষ্যতের সংস্করণে, ন্যানোএক্সচেঞ্জরেটের অনুকূলে এক্সচেঞ্জ রেট সরিয়ে দেওয়া হবে। |