Method: externaltransactions.refundexternaltransaction

ردّ أموال معاملة خارجية حالية أو ردّ جزء من أموالها

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
name

string

مطلوب. اسم المعاملة الخارجية التي سيتم ردّ أموالها التنسيق: Apps/{packageName}/externalTransaction/{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)

مطلوب. الوقت الذي تم فيه ردّ أموال المعاملة.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
حقل الاتحاد refund_type. مطلوب. نوع عملية ردّ أموال المعاملات الخارجية يمكن أن يكون refund_type واحدًا فقط مما يلي:
partialRefund

object (PartialRefund)

ردّ جزء من الأموال
fullRefund

object (FullRefund)

ردّ المبلغ بالكامل

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال ExternalTransaction.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

PartialRefund

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

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

string

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

object (Price)

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

FullRefund

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

ردّ كامل للمبلغ المتبقي من المعاملة.