- HTTP অনুরোধ
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- রিফান্ড রেজাল্টকোড
- রিফান্ড রেজাল্ট নোটিফিকেশন রেজাল্ট কোড
একটি refund পদ্ধতি কল করার পরে একটি অর্থ ফেরতের ফলাফল সম্পর্কে Google-কে অবহিত করুন৷
refund মেথড কলের সময় রিফান্ডগুলি সিঙ্ক্রোনাসভাবে পরিচালনা করা উচিত, তবে এই পদ্ধতিটি Google কে দ্রুত ব্যাকআপ সিগন্যাল প্রদান করে যদি সিঙ্ক্রোনাস কলটি অ্যাকশনটি সম্পাদন করার পরে ব্যর্থ হয় তবে ফলাফল ফেরত দেওয়ার আগে। এটি ভবিষ্যতের সময়ের জন্য পুনরায় চেষ্টা করার সময়সূচী করে Google দ্বারা প্রবর্তিত বিলম্ব এড়ায়।
এই refundRequestId জন্য refundResult মানটি অদম্য, তাই এই পদ্ধতিতে পরবর্তী কলের মাধ্যমে এর মান পরিবর্তন করা যাবে না।
অনুরোধটি প্রক্রিয়া করার সময় যদি এন্ডপয়েন্ট কোনো ত্রুটির সম্মুখীন হয়, তাহলে এই এন্ডপয়েন্ট থেকে পাওয়া প্রতিক্রিয়া হবে টাইপ।ErrorResponse
যদি এই পদ্ধতিটি HTTP 200 ফেরত না দেয় তবে এই প্রশ্নের উত্তরগুলি খালি হতে পারে৷ প্রতিক্রিয়ার অংশটি এমন পরিস্থিতিতে খালি থাকে যেখানে একটি স্পষ্ট বিবরণ সহ একটি আক্রমণকারীকে অন্যান্য ইন্টিগ্রেটরগুলির পেমেন্ট ইন্টিগ্রেটর অ্যাকাউন্ট শনাক্তকারীকে বুঝতে সাহায্য করার জন্য ব্যবহার করা যেতে পারে৷ এই পরিস্থিতিতে, যেখানে হয় সাইনিং কী মেলে না, পেমেন্ট ইন্টিগ্রেটর শনাক্তকারী পাওয়া যায়নি, বা এনক্রিপশন কী অজানা ছিল, এই পদ্ধতিটি একটি খালি বডি সহ HTTP 404 ফিরিয়ে দেবে। যদি অনুরোধ স্বাক্ষর যাচাই করা যায়, ত্রুটি সংক্রান্ত অতিরিক্ত তথ্য প্রতিক্রিয়া বডিতে ফেরত দেওয়া হবে।ErrorResponse
একটি উদাহরণ অনুরোধ এর মত দেখায়:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 1,
"revision": 0
},
"requestId": "HsKv5pvtQKTtz7rdcw1YqE",
"requestTimestamp": "1481855928301"
},
"paymentIntegratorAccountId": "InvisiCashUSA_USD",
"refundRequestId": "hH1T32PI86CpKwjuf6oD2r",
"paymentIntegratorRefundId": "invisi/Id::xx__1243",
"refundResult": "SUCCESS"
}
একটি উদাহরণ প্রতিক্রিয়া মত দেখায়:
{
"responseHeader": {
"responseTimestamp": "1481855928376"
},
"result": "SUCCESS"
}
HTTP অনুরোধ
POST https://vgw.googleapis.com/secure-serving/gsp/v1/refundResultNotification/ :PIAID
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
| JSON প্রতিনিধিত্ব |
|---|
{ "requestHeader": { object ( |
| ক্ষেত্র | |
|---|---|
requestHeader | প্রয়োজনীয় : সমস্ত অনুরোধের জন্য সাধারণ শিরোনাম। |
paymentIntegratorAccountId | প্রয়োজনীয় : পেমেন্ট ইন্টিগ্রেটর অ্যাকাউন্ট আইডেন্টিফায়ার যার উপর রিফান্ড হয়েছে। |
refundRequestId | প্রয়োজনীয় : এই রিফান্ডের জন্য স্বতন্ত্র শনাক্তকারী, |
refundResult | প্রয়োজনীয় : এই ফেরতের ফলাফল। |
paymentIntegratorRefundId | প্রয়োজনীয় : এই শনাক্তকারীটি ইন্টিগ্রেটরের জন্য নির্দিষ্ট এবং ইন্টিগ্রেটর দ্বারা তৈরি করা হয়। এই আইডেন্টিফায়ার যে ইন্টিগ্রেটর এই রিফান্ড জানে। সুবিধার জন্য, এই শনাক্তকারীকে রেমিটেন্সের বিবরণের সাথে অন্তর্ভুক্ত করা হয়েছে |
প্রতিক্রিয়া শরীর
refundResultNotification পদ্ধতির জন্য প্রতিক্রিয়া বস্তু।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
| JSON প্রতিনিধিত্ব |
|---|
{ "responseHeader": { object ( |
| ক্ষেত্র | |
|---|---|
responseHeader | প্রয়োজনীয় : সমস্ত প্রতিক্রিয়ার জন্য সাধারণ শিরোনাম। |
result | প্রয়োজনীয় : এই কলের ফলাফল। |
রিফান্ড রেজাল্টকোড
অনন্য ফলাফল কোড ফেরত.
| Enums | |
|---|---|
UNKNOWN_RESULT | এই ডিফল্ট মান সেট করবেন না! |
SUCCESS | সফল ফেরত. |
NO_MONEY_LEFT_ON_TRANSACTION | ফেরত ব্যর্থ হয়েছে, লেনদেনে কোনো টাকা অবশিষ্ট নেই। সাধারণত এটি ইন্টিগ্রেটর এবং গুগলের মধ্যে বাগ উপস্থাপন করে। Google এর আসল ক্যাপচারের চেয়ে বেশি অর্থ ফেরত দিতে বলা উচিত নয়। |
ACCOUNT_CLOSED | ইন্টিগ্রেটরের কাছে থাকা অ্যাকাউন্টটি বন্ধ করে দেওয়া হয়েছে। এই মান ফিরিয়ে দিলে ব্যবহারকারীর যন্ত্র Google-এর সাথে বন্ধ হয়ে যাবে। ব্যবহারকারী আবার অ্যাসোসিয়েশন প্রবাহের মধ্য দিয়ে গিয়ে একটি নতুন উপকরণ যোগ করতে বাধ্য হবে। |
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER | ইন্টিগ্রেটরের সাথে ব্যবহারকারীর অ্যাকাউন্ট বন্ধ করা হয়েছে, সন্দেহজনক অ্যাকাউন্ট দখল করা হয়েছে। এই মান ফিরিয়ে দিলে ব্যবহারকারীর যন্ত্র Google-এর সাথে বন্ধ হয়ে যাবে। ব্যবহারকারী আবার অ্যাসোসিয়েশন প্রবাহের মধ্য দিয়ে গিয়ে একটি নতুন উপকরণ যোগ করতে বাধ্য হবে। |
ACCOUNT_CLOSED_FRAUD | ইন্টিগ্রেটরের সাথে থাকা ব্যবহারকারীর অ্যাকাউন্ট প্রতারণার কারণে বন্ধ করা হয়েছে। এই মান ফিরিয়ে দিলে ব্যবহারকারীর যন্ত্র Google-এর সাথে বন্ধ হয়ে যাবে। ব্যবহারকারী আবার অ্যাসোসিয়েশন প্রবাহের মধ্য দিয়ে গিয়ে একটি নতুন উপকরণ যোগ করতে বাধ্য হবে। |
ACCOUNT_ON_HOLD | ব্যবহারকারীর অ্যাকাউন্ট বর্তমানে হোল্ডে আছে এবং ফেরত গ্রহণ করতে পারে না, তবে ব্যবহারকারীর অ্যাকাউন্ট পরে ফেরত গ্রহণ করতে সক্ষম হতে পারে। Google ভবিষ্যতে অন্য টাকা ফেরতের অনুরোধ করতে পারে, কিন্তু একটি নতুন requestId দিয়ে তা করবে, তাই এই অনুরোধটি সমাপ্ত বলে বিবেচনা করা উচিত। |
REFUND_EXCEEDS_MAXIMUM_BALANCE | বর্তমান সময়ে রিফান্ড প্রক্রিয়া করা যাবে না, কারণ এটি করার ফলে ব্যবহারকারীর ব্যালেন্স সর্বাধিক অনুমোদিত পরিমাণ ছাড়িয়ে যাবে। Google ভবিষ্যতে অন্য টাকা ফেরতের অনুরোধ করতে পারে, কিন্তু একটি নতুন requestId দিয়ে তা করবে, তাই এই অনুরোধটি সমাপ্ত বলে বিবেচনা করা উচিত। |
REFUND_WINDOW_EXCEEDED | রিফান্ড প্রক্রিয়া করা যাবে না কারণ অনুরোধটি অনুমোদিত রিফান্ড সময়ের বাইরে। |
রিফান্ড রেজাল্ট নোটিফিকেশন রেজাল্ট কোড
refundResultNotification পদ্ধতির জন্য ফলাফল কোড।
| Enums | |
|---|---|
UNKNOWN_RESULT | এই ডিফল্ট মান সেট করবেন না! |
SUCCESS | ফেরত ফলাফল বিজ্ঞপ্তি সফল হয়েছে. |