Method: externaltransactions.refundexternaltransaction

একটি বিদ্যমান বাহ্যিক লেনদেন ফেরত বা আংশিকভাবে ফেরত দেয়।

HTTP অনুরোধ

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

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

পাথ প্যারামিটার

পরামিতি
name

string

প্রয়োজন। বাহ্যিক লেনদেনের নাম যা ফেরত দেওয়া হবে। বিন্যাস: অ্যাপ্লিকেশন/{packageName}/externalTransactions/{externalTransaction}

শরীরের অনুরোধ

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

JSON প্রতিনিধিত্ব 
{
  "refundTime": string,

  // Union field refund_type can be only one of the following:
  "partialRefund": {
    object (PartialRefund)
  },
  "fullRefund": {
    object (FullRefund)
  }
  // End of list of possible types for union field refund_type.
}
ক্ষেত্র
refundTime

string ( Timestamp format)

প্রয়োজন। লেনদেন ফেরত দেওয়ার সময়।

RFC 3339 ব্যবহার করে, যেখানে উৎপন্ন আউটপুট সর্বদা Z-সাধারণ করা হবে এবং 0, 3, 6 বা 9 ভগ্নাংশ সংখ্যা ব্যবহার করে। "Z" ব্যতীত অন্যান্য অফসেটগুলিও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" বা "2014-10-02T15:01:23+05:30"

ইউনিয়ন ফিল্ড refund_type । প্রয়োজন। বাহ্যিক লেনদেনের অর্থ ফেরতের প্রকার। refund_type নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
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 )

প্রয়োজন। আংশিক ফেরতের প্রাক-কর পরিমাণ। লেনদেনের অবশিষ্ট প্রাক-ট্যাক্স পরিমাণের চেয়ে কম হওয়া উচিত।

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

এই ধরনের কোন ক্ষেত্র নেই.

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