Method: externaltransactions.refundexternaltransaction

আগে থেকে থাকা এক্সটার্নাল ট্রানজ্যাকশন রিফান্ড বা আংশিক রিফান্ড করে।

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

PartialRefund

কোনও ট্রানজ্যাকশনের আংশিক রিফান্ড।

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

string

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

refundPreTaxAmount

object (Price)

প্রয়োজনীয়। আংশিক রিফান্ডের ট্যাক্স-পূর্ব পরিমাণ। ট্রানজ্যাকশনের বাকি থাকা প্রি-ট্যাক্স পরিমাণের থেকে কম হতে হবে।

FullRefund

এই ধরনের কোনও ফিল্ড নেই।

কোনও ট্রানজ্যাকশনের বাকি থাকা পরিমাণের ফুল রিফান্ড।