Method: remittanceStatementDetails

একটি রেমিট্যান্স বিবৃতি সম্পর্কে লেনদেনের বিস্তারিত তথ্য প্রদান করে।

এটি একটি পেজিনেটেড API। প্রতি পৃষ্ঠায় লেনদেনের ইভেন্টের সংখ্যা numberOfEvents দিয়ে নির্দিষ্ট করা যেতে পারে। অনির্দিষ্ট থাকলে, প্রতি পৃষ্ঠায় সর্বাধিক 1000টি ইভেন্ট ফেরত দেওয়া হবে। এই API-এর প্রতিটি অনুরোধ বিবৃতিতে পরবর্তী লেনদেনের ইভেন্টের সাথে সাথে বিবৃতিতে মোট লেনদেনের সংখ্যা নির্দিষ্ট করে মোট totalEvents নির্দেশ করে একটি nextEventOffset ফেরত দেবে। যদি বর্তমান পুনরুদ্ধার করা পৃষ্ঠায় বিবৃতির শেষ লেনদেন থাকে, তাহলে nextEventOffset প্রতিক্রিয়াতে উপস্থিত থাকবে না।

statementId মান হল remittanceStatementNotificationRequest থেকে প্রাপ্ত requestId

অনুরোধটি প্রক্রিয়া করার সময় যদি এন্ডপয়েন্ট কোনো ত্রুটির সম্মুখীন হয়, তাহলে এই এন্ডপয়েন্ট থেকে পাওয়া প্রতিক্রিয়া হবে ErrorResponse টাইপ।

যদি এই পদ্ধতিটি HTTP 200 ফেরত না দেয় তবে এই প্রশ্নের উত্তরগুলি খালি হতে পারে৷ প্রতিক্রিয়ার অংশটি এমন পরিস্থিতিতে খালি থাকে যেখানে একটি স্পষ্ট বিবরণ সহ একটি ErrorResponse আক্রমণকারীকে অন্যান্য ইন্টিগ্রেটরের পেমেন্ট ইন্টিগ্রেটর অ্যাকাউন্ট শনাক্তকারী বুঝতে সাহায্য করতে ব্যবহার করা যেতে পারে৷ এই পরিস্থিতিতে, যেখানে হয় সাইনিং কী মেলে না, পেমেন্ট ইন্টিগ্রেটর শনাক্তকারী পাওয়া যায়নি, বা এনক্রিপশন কী অজানা ছিল, এই পদ্ধতিটি একটি খালি বডি সহ HTTP 404 ফিরিয়ে দেবে। যদি অনুরোধ স্বাক্ষর যাচাই করা যায়, ত্রুটি সংক্রান্ত অতিরিক্ত তথ্য প্রতিক্রিয়া বডিতে ফেরত দেওয়া হবে।

একটি উদাহরণ অনুরোধ এর মত দেখায়:


{
  "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": string,
  "statementId": string,
  "eventOffset": integer,
  "numberOfEvents": integer
}
ক্ষেত্র
requestHeader

object ( RequestHeader )

প্রয়োজনীয় : সমস্ত অনুরোধের জন্য সাধারণ শিরোনাম।

paymentIntegratorAccountId

string

প্রয়োজনীয় : এটি হল পেমেন্ট ইন্টিগ্রেটর অ্যাকাউন্ট আইডেন্টিফায়ার যা এই স্টেটমেন্টের চারপাশে চুক্তির সীমাবদ্ধতা চিহ্নিত করে।

statementId

string

প্রয়োজনীয় : বিবৃতি বিজ্ঞপ্তির অনুরোধ আইডি।

eventOffset

integer

ঐচ্ছিক : এই অফসেট থেকে শুরু হওয়া ইভেন্টগুলি ফেরত দিন৷ এটিকে nextEventOffset সেট করা উচিত যদি একটি ফেরত দেওয়া হয় বা অনির্দিষ্ট রেখে দেওয়া হয় যদি এটি প্রথম অনুরোধ হয়। eventOffset শূন্য হলে, প্রথম ইভেন্ট দিয়ে শুরু করে ইভেন্টগুলি ফেরত দেওয়া হবে। এটি দুটি হলে, তৃতীয় ইভেন্ট দিয়ে শুরু করে ইভেন্ট ফেরত দেওয়া হবে। অনির্দিষ্ট হলে, eventOffset শূন্য বলে ধরে নেওয়া হবে।

numberOfEvents

integer

ঐচ্ছিক : প্রতি পৃষ্ঠায় দেখানোর জন্য ইভেন্টের সংখ্যা। অনির্দিষ্ট বা 1000 এর বেশি হলে, এটি 1000 হবে।

প্রতিক্রিয়া শরীর

রেমিটেন্স বিবৃতি বিস্তারিত পদ্ধতির জন্য প্রতিক্রিয়া বস্তু.

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "remittanceStatementSummary": {
    object (RemittanceStatementSummary)
  },
  "eventOffset": integer,
  "nextEventOffset": integer,
  "totalEvents": integer,
  "totalWithholdingTaxes": string,
  "captureEvents": [
    {
      object (Event)
    }
  ],
  "refundEvents": [
    {
      object (Event)
    }
  ],
  "reverseRefundEvents": [
    {
      object (Event)
    }
  ],
  "chargebackEvents": [
    {
      object (Event)
    }
  ],
  "reverseChargebackEvents": [
    {
      object (Event)
    }
  ],
  "adjustmentEvents": [
    {
      object (Event)
    }
  ]
}
ক্ষেত্র
responseHeader

object ( ResponseHeader )

প্রয়োজনীয় : সমস্ত প্রতিক্রিয়ার জন্য সাধারণ শিরোনাম।

remittanceStatementSummary

object ( RemittanceStatementSummary )

প্রয়োজনীয় : এই রেমিটেন্স স্টেটমেন্টের সারাংশ।

eventOffset

integer

প্রয়োজনীয় : এই প্রতিক্রিয়ার ইভেন্ট অফসেট।

nextEventOffset

integer

ঐচ্ছিক : ফেরার জন্য পরবর্তী ইভেন্টের অফসেট। অনির্দিষ্ট থাকলে এই বিবৃতিটি পুনরুদ্ধার করার জন্য আর কোন ইভেন্ট নেই।

totalEvents

integer

প্রয়োজনীয় : এই বিবৃতিতে ইভেন্টের মোট সংখ্যা।

totalWithholdingTaxes

string ( Int64Value format)

প্রয়োজনীয় : এই বিবৃতিটির জন্য আটকে রাখা সমস্ত করের সমষ্টি৷

এই মানটি মাইক্রোতে রয়েছে।

captureEvents[]

object ( Event )

প্রয়োজনীয় : ক্যাপচার ইভেন্টের সেট।

refundEvents[]

object ( Event )

প্রয়োজনীয় : রিফান্ড ইভেন্টের সেট।

reverseRefundEvents[]

object ( Event )

ঐচ্ছিক : রিভার্স রিফান্ড ইভেন্টের সেট।

chargebackEvents[]

object ( Event )

ঐচ্ছিক : চার্জব্যাক ইভেন্টের সেট।

reverseChargebackEvents[]

object ( Event )

ঐচ্ছিক : বিপরীত চার্জব্যাক ইভেন্টের সেট।

adjustmentEvents[]

object ( Event )

ঐচ্ছিক : সমন্বয় ইভেন্টের সেট। বিলিং বৈষম্যগুলি মিটমাট করার জন্য Google-এর বিবেচনার ভিত্তিতে সামঞ্জস্য ইভেন্টগুলি যোগ করা যেতে পারে, উদাহরণস্বরূপ যদি পূর্বের লেনদেনের একটি সেটের জন্য ফি কম গণনা করা হয়, তাহলে একটি সমন্বয়কে সম্পূর্ণরূপে সংহত করতে ব্যবহার করা যেতে পারে৷

রেমিট্যান্স স্টেটমেন্ট সারসংক্ষেপ

একটি রেমিটেন্স বিবৃতি সম্পর্কে সারাংশ বস্তু.

JSON প্রতিনিধিত্ব
{
  "statementDate": string,
  "billingPeriod": {
    object (BillingPeriod)
  },
  "dateDue": string,
  "currencyCode": string,
  "totalDueByIntegrator": string,
  "remittanceInstructions": {
    object (RemittanceInstructions)
  }
}
ক্ষেত্র
statementDate

string ( int64 format)

প্রয়োজনীয় : তারিখ (আমেরিকা/লস এঞ্জেলেসে) যে এই বিবৃতিটি তৈরি করা হয়েছিল৷

billingPeriod

object ( BillingPeriod )

প্রয়োজনীয় : বিলিং সময়কাল এই বিবৃতিটি কভার করে।

dateDue

string ( int64 format)

ঐচ্ছিক : যে তারিখে রেমিট্যান্স জমা হবে। এটি যুগ থেকে মিলিসেকেন্ড হিসাবে উপস্থাপিত হয়। এটি একটি তারিখ (এবং তাই বিলিং টাইমজোনে সর্বদা দিনের প্রথম মিলিসেকেন্ডে শুরু হবে)।

এটি সেট করা হয় যতক্ষণ না totalDueByIntegrator 0-এর বেশি হয়।

currencyCode

string

প্রয়োজনীয় : ISO 4217 3-অক্ষরের মুদ্রা কোড।

totalDueByIntegrator

string ( Int64Value format)

প্রয়োজনীয় : এই মানটি currencyCode মুদ্রায় মাইক্রোতে রয়েছে। এই মান সবসময় ইতিবাচক.

remittanceInstructions

object ( RemittanceInstructions )

প্রয়োজনীয় : কিভাবে পেমেন্ট পাঠাতে হয় তার বিশদ বিবরণ

বিলিং সময়ের

এই বিবৃতি বিলিং সময়কাল.

JSON প্রতিনিধিত্ব
{
  "startDate": string,
  "endDate": string
}
ক্ষেত্র
startDate

string ( int64 format)

প্রয়োজনীয় : বিলিং সময়ের শুরুর তারিখ। এটি যুগ থেকে মিলিসেকেন্ড হিসাবে উপস্থাপিত হয়। এটি একটি তারিখ (এবং তাই বিলিং টাইমজোনে সর্বদা দিনের প্রথম মিলিসেকেন্ডে শুরু হবে)।

এটি বিলিং সময়ের দিনের প্রথম মিলিসেকেন্ড, 00:00:00.000

endDate

string ( int64 format)

প্রয়োজনীয় : বিলিং সময়ের শেষ তারিখ। এটি যুগ থেকে মিলিসেকেন্ড হিসাবে উপস্থাপিত হয়।

এটি বিলিং সময়ের শেষ দিনের শেষ মিলিসেকেন্ড, 23:59:59.999

রেমিটেন্স নির্দেশাবলী

এই রেমিট্যান্স বিজ্ঞপ্তি কিভাবে পরিশোধ করতে হবে সে সম্পর্কে তথ্য ধারণ করা কাঠামো।

JSON প্রতিনিধিত্ব
{
  "memoLineId": string
}
ক্ষেত্র
memoLineId

string

প্রয়োজনীয় : রেমিট্যান্স সনাক্তকরণের জন্য অর্থপ্রদানের জন্য মেমো লাইনে থাকা বাধ্যতামূলক শনাক্তকারী।

ঘটনা

একটি রেমিটেন্স বিবৃতিতে অন্তর্ভুক্ত একটি একক ইভেন্টের প্রতিনিধিত্বকারী কাঠামো।

JSON প্রতিনিধিত্ব
{
  "eventRequestId": string,
  "paymentIntegratorEventId": string,
  "eventCharge": string,
  "eventFee": string,
  "presentmentChargeAmount": string,
  "presentmentCurrencyCode": string,
  "exchangeRate": string,
  "nanoExchangeRate": string
}
ক্ষেত্র
eventRequestId

string

প্রয়োজনীয় : ক্যাপচার বা রিফান্ড ইভেন্টের জন্য, Google অনুরোধের সাথে যে requestId পাঠাবে সেটিই হবে। রিভার্স রিফান্ড, চার্জব্যাক এবং রিভার্স চার্জব্যাক ইভেন্টের জন্য, পেমেন্ট ইন্টিগ্রেটর সেই ইভেন্টের বিজ্ঞপ্তির সাথে যে রিকোয়েস্ট requestId পাঠাবে তা হবে। সামঞ্জস্যের জন্য, এটি সমন্বয় ইভেন্টে Google দ্বারা নির্ধারিত একটি অনন্য আইডি হবে।

paymentIntegratorEventId

string

প্রয়োজনীয় : এই ইভেন্টের জন্য ফেরত পেমেন্ট ইন্টিগ্রেটর আইডি। একটি ক্যাপচারের জন্য এটি হল একটি capture কলের প্রতিক্রিয়া থেকে paymentIntegratorTransactionId , একটি ফেরতের জন্য এটি একটি refund কলের প্রতিক্রিয়া থেকে paymentIntegratorRefundId ।

এই ক্ষেত্রটি পরিবর্তনশীল দৈর্ঘ্যের, একটি ইন্টিগ্রেটর হিসাবে আপনি এই ইভেন্টের জন্য যে আইডি সরবরাহ করবেন তা এখানে প্রতিফলিত হবে। যদি সংশ্লিষ্ট ইভেন্টের জন্য ইন্টিগ্রেটর দ্বারা একটি মান প্রদান করা না হয়, তাহলে এই ক্ষেত্রটিতে eventRequestId ক্ষেত্রের মতো একই মান থাকবে।

রিভার্স রিফান্ড, চার্জব্যাক এবং রিভার্স চার্জব্যাক ইভেন্টের জন্য এটি সেই requestId হবে যা পেমেন্ট ইন্টিগ্রেটর ইভেন্টের বিজ্ঞপ্তির সাথে পাঠিয়েছে।

এই ক্ষেত্রের দৈর্ঘ্য এবং বিন্যাস প্রতিটি আইডির জন্য উৎস ক্ষেত্রের উপর নির্ভর করে। দৈর্ঘ্য এবং অক্ষর সেটের প্রয়োজনীয়তা সম্পর্কে বিশদ বিবরণের জন্য প্রতিটি উৎস ক্ষেত্রের জন্য ডকুমেন্টেশন পড়ুন। বিশেষ করে, মনে রাখবেন যে এই ক্ষেত্রটিতে কখনও কখনও Google-জেনারেট করা আইডি থাকতে পারে যার মধ্যে ইন্টিগ্রেটর-জেনারেটেড আইডিগুলির চেয়ে আলাদা সর্বোচ্চ দৈর্ঘ্যের প্রয়োজনীয়তা থাকতে পারে।

eventCharge

string ( Int64Value format)

প্রয়োজনীয় : বিবৃতি দ্বারা সংজ্ঞায়িত মুদ্রা কোডে। যদি এই মানটি ঋণাত্মক হয় তবে এটি Google থেকে পেমেন্ট ইন্টিগ্রেটরে চলে যাওয়া আর্থিক মূল্যকে উপস্থাপন করে। যদি এটি ইতিবাচক হয় তবে এটি Google-এর কারণে পেমেন্ট ইন্টিগ্রেটরের কাছ থেকে অর্থ।

উদাহরণস্বরূপ, ক্যাপচার লেনদেন সবসময় ইতিবাচক হবে, এবং ফেরত লেনদেন সবসময় নেতিবাচক হবে। রিভার্স রিফান্ড এবং রিভার্স চার্জব্যাক ইভেন্ট সবসময় ইতিবাচক হবে। চার্জব্যাক ইভেন্ট সবসময় নেতিবাচক হবে.

এই মানটি মাইক্রোতে রয়েছে।

eventFee

string ( Int64Value format)

প্রয়োজনীয় : বিবৃতি দ্বারা সংজ্ঞায়িত মুদ্রা কোডে। যদি এই মানটি ঋণাত্মক হয় তবে এটি Google থেকে পেমেন্ট ইন্টিগ্রেটরে চলে যাওয়া আর্থিক মূল্যকে উপস্থাপন করে। যদি এটি ইতিবাচক হয় তবে এটি Google-এর কারণে পেমেন্ট ইন্টিগ্রেটরের কাছ থেকে অর্থ।

উদাহরণস্বরূপ, যদি একটি চুক্তি বলে যে Google পেমেন্ট ইন্টিগ্রেটরকে transactionCharge 1% প্রদান করবে এবং সেই লেনদেনটি ফেরত দেওয়ার পরে 1% রিভার্স করবে, তাহলে ক্যাপচার ফি নেতিবাচক হবে এবং ফেরত দেওয়ার পরে রিফান্ড ফি ইতিবাচক হবে৷

এই মানটি মাইক্রোতে রয়েছে।

presentmentChargeAmount

string ( Int64Value format)

ঐচ্ছিক : বৈদেশিক মুদ্রার আগে উপস্থাপনা (ওরফে লেনদেন) মুদ্রায় লেনদেনের পরিমাণ। এই ক্ষেত্রটি eventCharge ফিল্ডের মতো একই সাইন কনভেনশন অনুসরণ করে।

এই মানটি মাইক্রোতে রয়েছে।

presentmentCurrencyCode

string

ঐচ্ছিক : আইএসও 4217 3-অক্ষরের মুদ্রা কোড যা উপস্থাপনা (লেনদেন) মুদ্রাকে চিহ্নিত করে।

exchangeRate

string ( Int64Value format)

ঐচ্ছিক : উপস্থাপনের পরিমাণকে নিষ্পত্তি (চালান) পরিমাণে রূপান্তর করতে ব্যবহৃত বিনিময় হার।

এই মানটি মাইক্রো বেসিস পয়েন্টে (1 বেসিস পয়েন্ট = .0001 = .01%)। অর্থাৎ, বিনিময় হার পেতে, এই ক্ষেত্রটিকে 10^10 দ্বারা ভাগ করুন।

nanoExchangeRate

string ( Int64Value format)

ঐচ্ছিক : ন্যানো বেসিস পয়েন্টে প্রকাশ করা, সেটেলমেন্ট (ইনভয়েস) পরিমাণে উপস্থাপনের পরিমাণ রূপান্তর করতে ব্যবহৃত বিনিময় হার।

এই মানটি ন্যানো বেসিস পয়েন্টে (1 বেসিস পয়েন্ট = .0001 = .01%)। অর্থাৎ, বিনিময় হার পেতে, এই ক্ষেত্রটিকে 10^13 দ্বারা ভাগ করুন।

এই ক্ষেত্র এবং বিনিময় হার উভয়ই জনবহুল হবে। এগুলি বিভিন্ন নির্ভুলতার সাথে প্রকাশ করা সমতুল্য বিনিময় হার। ভবিষ্যতের সংস্করণে, ন্যানোএক্সচেঞ্জরেটের অনুকূলে এক্সচেঞ্জ রেট সরিয়ে দেওয়া হবে।