Method: externaltransactions.refundexternaltransaction

• HTTP অনুরোধ
• পথের পরামিতি
• অনুরোধকারী শরীর
  • JSON উপস্থাপনা
• প্রতিক্রিয়া সংস্থা
• অনুমোদনের পরিধি
• আংশিক ফেরত
  • JSON উপস্থাপনা
• সম্পূর্ণ অর্থ ফেরত
• চেষ্টা করে দেখুন!

বিদ্যমান কোনো বাহ্যিক লেনদেনের সম্পূর্ণ বা আংশিক অর্থ ফেরত দেয়।

HTTP অনুরোধ

POST https://androidpublisher.googleapis.com/androidpublisher/v3/{name=applications/*/externalTransactions/*}:refund

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
name	string আবশ্যক। যে বাহ্যিক লেনদেনটি ফেরত দেওয়া হবে তার নাম। ফরম্যাট: applications/{packageName}/externalTransactions/{externalTransaction}

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা
{ "refundTime": string, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "partialRefund": { object (PartialRefund) }, "fullRefund": { object (FullRefund) } // End of mutually exclusive fields. }

ক্ষেত্র
refundTime	string ( Timestamp format) প্রয়োজনীয়। যে সময়ে লেনদেনটি ফেরত দেওয়া হয়েছিল। RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।
আবশ্যক। বাহ্যিক লেনদেন ফেরতের ধরণ। নিম্নলিখিতটি হলো পারস্পরিকভাবে বর্জনীয় ফিল্ডগুলির একটি তালিকা। একটি উত্তরে এই ফিল্ডগুলির মধ্যে সর্বাধিক একটি সেট করা হবে:
partialRefund	object ( PartialRefund ) আংশিক ফেরত।
fullRefund	object ( FullRefund ) সম্পূর্ণ অর্থ ফেরত।
পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে ExternalTransaction এর একটি ইনস্ট্যান্স থাকে।

নমুনা

নিম্নলিখিতটি একটি নমুনা অনুরোধ:

curl \
  -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/externalTransactions/foo:refund' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  -H 'Content-Type: application/json' \
  -d '{ \
    "partialRefund": { \
      "refundId": "my_refund_id", \
      "refundPreTaxAmount": { \
        "currency": "USD", \
        "priceMicros": "10120000" \
      } \
    }, \
    "refundTime": "2023-10-20T16:43:32.852Z" \
  }'

নিম্নলিখিতটি একটি নমুনা উত্তর:

{
  "externalTransactionId": "1234567890123456789012345678901234567890123456789012345678901234",
  "originalPreTaxAmount": {
    "currency": "USD",
    "priceMicros": "1990000"
  },
  "originalTaxAmount": {
    "currency": "USD",
    "priceMicros": "11400000"
  },
  "packageName": "com.example.app",
  "transactionState": "TRANSACTION_CANCELED",
  "transactionTime": "2023-04-01T12:00:00Z",
  "userTaxAddress": {
    "regionCode": "US"
  },
  "createTime": "2023-04-01T11:55:00Z",
  "currentPreTaxAmount": {
    "currency": "USD",
    "priceMicros": "0"
  },
  "currentTaxAmount": {
    "currency": "USD",
    "priceMicros": "0"
  },
  "testPurchase": {},
  "recurringTransaction": {
    "initialExternalTransactionId": "9876543210987654321098765432109876543210987654321098765432109876",
    "externalSubscription": {
      "subscriptionType": "RECURRING"
    }
  }
}

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

• https://www.googleapis.com/auth/androidpublisher

আংশিক ফেরত

কোনো লেনদেনের আংশিক ফেরত।

JSON উপস্থাপনা
{ "refundId": string, "refundPreTaxAmount": { object (Price) } }

ক্ষেত্র
refundId	string আবশ্যক। এই আংশিক রিফান্ডটি শনাক্ত করার জন্য একটি অনন্য আইডি প্রয়োজন। রিফান্ডটি সফল হলে, একই আইডি দিয়ে করা পরবর্তী রিফান্ডগুলো ব্যর্থ হবে। একটি নির্দিষ্ট লেনদেনের ক্ষেত্রে সমস্ত রিফান্ডের জন্য আইডিটি অবশ্যই অনন্য হতে হবে।
refundPreTaxAmount	object ( Price ) আবশ্যক। আংশিক ফেরতের কর-পূর্ব পরিমাণ অবশ্যই লেনদেনটির অবশিষ্ট কর-পূর্ব পরিমাণের চেয়ে কম হতে হবে।

সম্পূর্ণ অর্থ ফেরত

এই প্রকারে কোনো ক্ষেত্র নেই।

লেনদেনের অবশিষ্ট অর্থের সম্পূর্ণ ফেরত।