Method: refund

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": string,
  "captureRequestId": string,
  "currencyCode": string,
  "refundAmount": string
}
ক্ষেত্র
requestHeader

object ( RequestHeader )

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

paymentIntegratorAccountId

string

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

captureRequestId

string

প্রয়োজনীয় : এই লেনদেনের জন্য একটি অনন্য শনাক্তকারী। এটি capture কলের সময় Google দ্বারা তৈরি করা requestId যার সাথে এই অনুরোধটি যুক্ত।

currencyCode

string

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

refundAmount

string ( Int64Value format)

প্রয়োজনীয় : ফেরতের পরিমাণ, মুদ্রা ইউনিটের একটি ধনাত্মক সংখ্যা মাইক্রো ।

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

রিফান্ড পদ্ধতির জন্য প্রতিক্রিয়া বস্তু।

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

JSON প্রতিনিধিত্ব
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "paymentIntegratorRefundId": string,
  "result": enum (RefundResultCode),
  "rawResult": {
    object (RawResult)
  }
}
ক্ষেত্র
responseHeader

object ( ResponseHeader )

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

paymentIntegratorRefundId

string

ঐচ্ছিক : এই শনাক্তকারীটি ইন্টিগ্রেটরের জন্য নির্দিষ্ট এবং ইন্টিগ্রেটর দ্বারা তৈরি করা হয়। এই আইডেন্টিফায়ার যে ইন্টিগ্রেটর এই রিফান্ড জানে।

সুবিধার জন্য, এই শনাক্তকারীকে রেমিটেন্সের বিবরণের সাথে অন্তর্ভুক্ত করা হয়েছে

result

enum ( RefundResultCode )

প্রয়োজনীয় : এই ফেরতের ফলাফল।

rawResult

object ( RawResult )

ঐচ্ছিক : এই রিফান্ডের অশোধিত ফলাফল। Google এর ঝুঁকিপূর্ণ ইঞ্জিন এবং বিশ্লেষণে সহায়তা করতে ব্যবহৃত হয়। ডিক্লাইন কোড-ম্যাপিং পরিস্থিতিতে, ডেটা কখনও কখনও হারিয়ে যায়। ইন্টিগ্রেটর গুগলকে একটি কাঁচা কোড দিতে বেছে নিতে পারে। উদাহরণস্বরূপ, একটি ক্রেডিট কার্ড গেটওয়ে (একীকরণকারী) এই ক্ষেত্রটি ব্যবহার করতে পারে Google এর সাথে যোগাযোগ করার জন্য সঠিক ডিক্লাইন কোড যা VISA নেটওয়ার্ক থেকে প্রাপ্ত হয়েছিল। সেক্ষেত্রে, scope হবে "ভিসা" এবং VISA নেটওয়ার্ক ফেরত দেওয়া যাই হোক না কেন rawCode হবে৷

result SUCCESS না হলে এই মানটি প্রয়োজন ৷

রিফান্ড রেজাল্টকোড

অনন্য ফলাফল কোড ফেরত.

এনামস
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 রিফান্ড প্রক্রিয়া করা যাবে না কারণ অনুরোধটি অনুমোদিত রিফান্ড সময়ের বাইরে।