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,

  // 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

PartialRefund

ردّ جزء من الأموال المدفوعة في معاملة

تمثيل JSON 
{
  "refundId": string,
  "refundPreTaxAmount": {
    object (Price)
  }
}
الحقول
refundId

string

مطلوب. معرّف فريد يميز عملية ردّ الأموال الجزئية هذه إذا تم ردّ الأموال بنجاح، لن تنجح عمليات ردّ الأموال اللاحقة التي تحمل المعرّف نفسه. يجب أن يكون فريدًا في عمليات ردّ الأموال لمعاملة فردية واحدة.
refundPreTaxAmount

object (Price)

مطلوب. المبلغ قبل احتساب الضريبة لردّ جزء من الأموال. يجب أن يكون أقل من المبلغ المتبقّي من المعاملة قبل احتساب الضريبة.

FullRefund

لا يحتوي هذا النوع على أي حقول.

ردّ الأموال بالكامل المدفوعة في معاملة معيّنة