- HTTP অনুরোধ
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- অনুরোধ শিরোনাম
- সংস্করণ
- রেমিট্যান্স স্টেটমেন্ট সারসংক্ষেপ
- বিলিং সময়ের
- রেমিটেন্স নির্দেশাবলী
- রেসপন্স হেডার
- বিবৃতি বিজ্ঞপ্তি ফলাফল কোড
একটি নতুন রেমিট্যান্স স্টেটমেন্টের ইন্টিগ্রেটরকে অবহিত করে।
বিবৃতি বিজ্ঞপ্তিগুলি যখনই একটি নতুন বিবৃতি উত্থাপিত হয় তখনই ঘটে যা অর্থের প্রতিনিধিত্ব করে যে Google ইন্টিগ্রেটরকে অর্থ প্রদান করবে বা ইন্টিগ্রেটর Googleকে যে অর্থ প্রদান করবে।
যদি ইন্টিগ্রেটর একটি সফলতা ফেরত দেয়, তাহলে এটি বিবৃতিটির প্রাপ্তি স্বীকার করে।
requestId
বিবৃতি আইডি (অন্য কোথাও ব্যবহৃত হয়)। হেডার এবং paymentIntegratorAccountId
এর মধ্যে requestId
এর সংমিশ্রণ হল idempotency কী এবং অনন্যভাবে এই বিবৃতিটিকে চিহ্নিত করে।
অনুরোধটি প্রক্রিয়া করার সময় যদি এন্ডপয়েন্টটি একটি ত্রুটির সম্মুখীন হয়, তাহলে এই এন্ডপয়েন্ট থেকে রেসপন্স বডিটি
টাইপ হওয়া উচিত।ErrorResponse
একটি উদাহরণ অনুরোধ এর মত দেখায়:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 0,
"revision": 0
},
"requestId": "0123434-statement-abc",
"requestTimestamp": "1502632800000"
},
"paymentIntegratorAccountId": "InvisiCashUSA_USD",
"remittanceStatementSummary": {
"statementDate": "1502607600000",
"billingPeriod": {
"startDate": "1502434800000",
"endDate": "1502521199000"
},
"dateDue": "1503212400000",
"currencyCode": "INR",
"totalDueByIntegrator": "1076000000",
"remittanceInstructions": {
"memoLineId": "stmt-1AB-pp0-invisi"
}
}
}
একটি উদাহরণ প্রতিক্রিয়া মত দেখায়:
{
"responseHeader": {
"responseTimestamp": "1502632802000"
},
"paymentIntegratorStatementId": "334a",
"result": "ACCEPTED"
}
HTTP অনুরোধ
POST https://www.integratorhost.example.com/v1/remittanceStatementNotification
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব |
---|
{ "requestHeader": { object ( |
ক্ষেত্র | |
---|---|
requestHeader | প্রয়োজনীয় : সমস্ত অনুরোধের জন্য সাধারণ শিরোনাম। |
paymentIntegratorAccountId | প্রয়োজনীয় : এটি হল পেমেন্ট ইন্টিগ্রেটর অ্যাকাউন্ট আইডেন্টিফায়ার যা এই স্টেটমেন্টের চারপাশে চুক্তির সীমাবদ্ধতা চিহ্নিত করে। |
remittanceStatementSummary | প্রয়োজনীয় : এই রেমিটেন্স স্টেটমেন্টের সারাংশ। |
প্রতিক্রিয়া শরীর
রেমিট্যান্স বিবৃতি বিজ্ঞপ্তি পদ্ধতির জন্য প্রতিক্রিয়া বস্তু।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
JSON প্রতিনিধিত্ব |
---|
{ "responseHeader": { object ( |
ক্ষেত্র | |
---|---|
responseHeader | প্রয়োজনীয় : সমস্ত প্রতিক্রিয়ার জন্য সাধারণ শিরোনাম। |
paymentIntegratorStatementId | প্রয়োজনীয় : ইন্টিগ্রেটর শনাক্তকারী এই বিবৃতিটি জানেন। এই ইন্টিগ্রেটর উত্পন্ন হয়. |
result | প্রয়োজনীয় : এই বিবৃতি বিজ্ঞপ্তি ফলাফল. |
অনুরোধ শিরোনাম
হেডার অবজেক্ট যা সার্ভারে পাঠানো সমস্ত অনুরোধে সংজ্ঞায়িত করা হয়।
JSON প্রতিনিধিত্ব |
---|
{
"requestId": string,
"requestTimestamp": string,
"userLocale": string,
"protocolVersion": {
object ( |
ক্ষেত্র | |
---|---|
requestId | প্রয়োজনীয় : এই অনুরোধের অনন্য শনাক্তকারী। এটি এমন একটি স্ট্রিং যার সর্বোচ্চ দৈর্ঘ্য 100টি অক্ষর, এবং এতে শুধুমাত্র "az", "AZ", "0-9", ":", "-", এবং "_" অক্ষর রয়েছে। |
requestTimestamp | প্রয়োজনীয় : এই অনুরোধের টাইমস্ট্যাম্প যুগের পর থেকে মিলিসেকেন্ড হিসাবে উপস্থাপন করা হয়েছে। প্রাপকের অবশ্যই যাচাই করা উচিত যে এই টাইমস্ট্যাম্পটি 'এখন' এর ± 60s। এই অনুরোধ টাইমস্ট্যাম্প পুনঃপ্রচেষ্টার উপর অদম্য নয়। |
userLocale | অপ্রচলিত : একটি দুই- বা তিন-অক্ষরের ISO 639-2 Alpha 3 ভাষা কোড ঐচ্ছিকভাবে একটি হাইফেন এবং একটি ISO 3166-1 Alpha-2 দেশের কোড, যেমন'pt', 'pt-BR', 'fil', অথবা 'fil-PH'। প্রতিক্রিয়ায় |
protocolVersion | প্রয়োজনীয় : এই অনুরোধের সংস্করণ। |
সংস্করণ
সংস্করণ অবজেক্ট যা ক্লাসিক abc
সংস্করণ কাঠামোর একটি কাঠামোবদ্ধ রূপ। একই সংখ্যার প্রধান সংস্করণগুলি সামঞ্জস্যপূর্ণ হওয়ার গ্যারান্টিযুক্ত। নোট করুন যে গৌণ এবং সংশোধন ঘন ঘন এবং বিজ্ঞপ্তি ছাড়াই পরিবর্তিত হতে পারে। ইন্টিগ্রেটরকে অবশ্যই একই প্রধান সংস্করণের জন্য সমস্ত অনুরোধ সমর্থন করতে হবে।
JSON প্রতিনিধিত্ব |
---|
{ "major": integer, "minor": integer, "revision": integer } |
ক্ষেত্র | |
---|---|
major | প্রয়োজনীয় : প্রধান সংস্করণ। এটি বিভিন্ন সংস্করণের সাথে সামঞ্জস্যের অনুরোধগুলির জন্য চিহ্নিত করা হয়েছে যেগুলি সামঞ্জস্যপূর্ণ হওয়ার নিশ্চয়তা নেই৷ |
minor | প্রয়োজনীয় : ছোট সংস্করণ। এটি উল্লেখযোগ্য বাগ সংশোধন নির্দেশ করে। |
revision | প্রয়োজনীয় : ছোট সংস্করণ। এটি ছোটখাট বাগ ফিক্স বোঝায়। |
রেমিট্যান্স স্টেটমেন্ট সারসংক্ষেপ
একটি রেমিটেন্স বিবৃতি সম্পর্কে সারাংশ বস্তু.
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 প্রতিনিধিত্ব |
---|
{ "responseTimestamp": string } |
ক্ষেত্র | |
---|---|
responseTimestamp | প্রয়োজনীয় : এই প্রতিক্রিয়ার টাইমস্ট্যাম্প যুগ থেকে মিলিসেকেন্ড হিসাবে উপস্থাপন করা হয়েছে। প্রাপকের অবশ্যই যাচাই করা উচিত যে এই টাইমস্ট্যাম্পটি 'এখন' এর ± 60s। |
বিবৃতি বিজ্ঞপ্তি ফলাফল কোড
বিবৃতি বিজ্ঞপ্তি জন্য ফলাফল কোড.
এনামস | |
---|---|
UNKNOWN_RESULT | এই ডিফল্ট মান সেট করবেন না! |
ACCEPTED | ইন্টিগ্রেটর এই বিবৃতি গ্রহণ করেছে. |