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

لا يتضمّن هذا النوع أي حقول.

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