Method: externaltransactions.refundexternaltransaction

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

طلب HTTP

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

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

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

المَعلمات
name

string

مطلوبة. اسم المعاملة الخارجية التي سيتم ردّ الأموال المدفوعة فيها التنسيق: التطبيقات/{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 "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

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

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