capture
মাধ্যমে শুরু হওয়া পুরো লেনদেনের একটি অংশ বা ফেরত দেয়। হেডার এবং paymentIntegratorAccountId
এর মধ্যে requestId
এর সংমিশ্রণ হল idempotency কী, যা এই লেনদেনটিকে অনন্যভাবে চিহ্নিত করে।
অনুরোধটি প্রক্রিয়া করার সময় যদি এন্ডপয়েন্টটি একটি ত্রুটির সম্মুখীন হয়, তাহলে এই এন্ডপয়েন্ট থেকে রেসপন্স বডিটি
টাইপ হওয়া উচিত।ErrorResponse
একটি উদাহরণ অনুরোধ এর মত দেখায়:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 0,
"revision": 0
},
"requestId": "liUrreQY233839dfFFb24gaQM",
"requestTimestamp": "1502220434778"
},
"paymentIntegratorAccountId": "InvisiCashUSA_USD",
"captureRequestId": "bWVyY2hhbnQgdHJhbnNhY3Rpb24gaWQ",
"currencyCode": "INR",
"refundAmount": "208000000"
}
একটি উদাহরণ প্রতিক্রিয়া মত দেখায়:
{
"responseHeader": {
"responseTimestamp": "1481900013178"
},
"result": "SUCCESS",
"paymentIntegratorRefundId": "cmVmdW5kIGlkZW50aWZpZXINCg"
}
HTTP অনুরোধ
POST https://www.integratorhost.example.com/v1/refund
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব |
---|
{
"requestHeader": {
object ( |
ক্ষেত্র | |
---|---|
requestHeader | প্রয়োজনীয় : সমস্ত অনুরোধের জন্য সাধারণ শিরোনাম। |
paymentIntegratorAccountId | প্রয়োজনীয় : এটি হল পেমেন্ট ইন্টিগ্রেটর অ্যাকাউন্ট আইডি যা এই লেনদেনের চারপাশে চুক্তিগত সীমাবদ্ধতাগুলিকে সংজ্ঞায়িত করে৷ |
captureRequestId | প্রয়োজনীয় : এই লেনদেনের জন্য একটি অনন্য শনাক্তকারী। এটি |
currencyCode | প্রয়োজনীয় : ISO 4217 3-অক্ষরের মুদ্রা কোড |
refundAmount | প্রয়োজনীয় : ফেরতের পরিমাণ, মুদ্রা ইউনিটের একটি ধনাত্মক সংখ্যা মাইক্রো । |
প্রতিক্রিয়া শরীর
রিফান্ড পদ্ধতির জন্য প্রতিক্রিয়া বস্তু।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
JSON প্রতিনিধিত্ব |
---|
{ "responseHeader": { object ( |
ক্ষেত্র | |
---|---|
responseHeader | প্রয়োজনীয় : সমস্ত প্রতিক্রিয়ার জন্য সাধারণ শিরোনাম। |
paymentIntegratorRefundId | ঐচ্ছিক : এই শনাক্তকারীটি ইন্টিগ্রেটরের জন্য নির্দিষ্ট এবং ইন্টিগ্রেটর দ্বারা তৈরি করা হয়। এই আইডেন্টিফায়ার যে ইন্টিগ্রেটর এই রিফান্ড জানে। সুবিধার জন্য, এই শনাক্তকারীকে রেমিটেন্সের বিবরণের সাথে অন্তর্ভুক্ত করা হয়েছে |
result | প্রয়োজনীয় : এই ফেরতের ফলাফল। |
rawResult | ঐচ্ছিক : এই রিফান্ডের অশোধিত ফলাফল। Google এর ঝুঁকিপূর্ণ ইঞ্জিন এবং বিশ্লেষণে সহায়তা করতে ব্যবহৃত হয়। ডিক্লাইন কোড-ম্যাপিং পরিস্থিতিতে, ডেটা কখনও কখনও হারিয়ে যায়। ইন্টিগ্রেটর গুগলকে একটি কাঁচা কোড দিতে বেছে নিতে পারে। উদাহরণস্বরূপ, একটি ক্রেডিট কার্ড গেটওয়ে (একীকরণকারী) এই ক্ষেত্রটি ব্যবহার করতে পারে Google এর সাথে যোগাযোগ করার জন্য সঠিক ডিক্লাইন কোড যা VISA নেটওয়ার্ক থেকে প্রাপ্ত হয়েছিল। সেক্ষেত্রে, |
রিফান্ড রেজাল্টকোড
অনন্য ফলাফল কোড ফেরত.
এনামস | |
---|---|
UNKNOWN_RESULT | এই ডিফল্ট মান সেট করবেন না! |
SUCCESS | সফল ফেরত. |
NO_MONEY_LEFT_ON_TRANSACTION | v1.refund ব্যর্থ হয়েছে, লেনদেনে কোনো টাকা অবশিষ্ট নেই। সাধারণত এটি ইন্টিগ্রেটর এবং গুগলের মধ্যে বাগ উপস্থাপন করে। 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 | রিফান্ড প্রক্রিয়া করা যাবে না কারণ অনুরোধটি অনুমোদিত রিফান্ড সময়ের বাইরে। |