Method: refund

ردّ جزء من المعاملة أو تم إجراؤها بالكامل من خلال capture إنّ الجمع بين requestId في العنوان وpaymentIntegratorAccountId هو مفتاح عدم النشاط الذي يحدّد هذه المعاملة بشكلٍ فريد.

في حال واجهت نقطة النهاية خطأ أثناء معالجة الطلب، يجب أن يكون نص الاستجابة من نقطة النهاية هذه من النوع ErrorResponse.

مثال على طلب يبدو:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "liUrreQY233839dfFFb24gaQM",
    "requestTimestamp": "1502220434778"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "captureRequestId": "bWVyY2hhbnQgdHJhbnNhY3Rpb24gaWQ",
  "currencyCode": "INR",
  "refundAmount": "208000000"
}

مثال على ردّ:


{
  "responseHeader": {
    "responseTimestamp": "1481900013178"
  },
  "result": "SUCCESS",
  "paymentIntegratorRefundId": "cmVmdW5kIGlkZW50aWZpZXINCg"
}

طلب HTTP

POST https://www.integratorhost.example.com/v1/refund

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "captureRequestId": string,
  "currencyCode": string,
  "refundAmount": string
}
الحقول
requestHeader

object (RequestHeader)

مطلوب: عنوان شائع لجميع الطلبات.
paymentIntegratorAccountId

string

مطلوب: هذا هو رقم تعريف حساب وحدة تكامل الدفعات الذي يحدِّد القيود التعاقدية بشأن هذه المعاملة.
captureRequestId

string

مطلوبة: معرّف فريد لهذه المعاملة هذا هو requestId الذي أنشأته Google خلال مكالمة capture التي يرتبط بها هذا الطلب.
currencyCode

string

مطلوبة: رمز العملة المكوّن من 3 أحرف وفقًا لمعيار ISO 4217
refundAmount

string (Int64Value format)

مطلوبة: مبلغ ردّ الأموال، ورقم موجب للمايكرو من وحدة العملة.

نص الاستجابة

عنصر الاستجابة لطريقة ردّ الأموال

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "paymentIntegratorRefundId": string,
  "result": enum (RefundResultCode),
  "rawResult": {
    object (RawResult)
  }
}
الحقول
responseHeader

object (ResponseHeader)

مطلوب: عنوان شائع لجميع الردود.
paymentIntegratorRefundId

string

اختياري: يكون هذا المعرّف مخصّصًا لعملية التكامل، ويتم إنشاؤه من خلال عملية الدمج. هذا هو المعرّف الذي يعرف به المسؤول عن عملية الدمج هذه.

ولتسهيل الأمر، يتم تضمين هذا المعرّف في تفاصيل الحوالة المالية.
result

enum (RefundResultCode)

مطلوب: نتيجة عملية ردّ الأموال هذه.
rawResult

object (RawResult)

اختياري: النتيجة الأولية لعملية ردّ الأموال هذه. يُستخدم هذا الخيار للمساعدة في تقديم معلومات عن محرك البحث والإحصاءات من Google. في حالات ربط الرمز، يتم فقدان البيانات أحيانًا. ومن الممكن أن يختار صاحب عملية التكامل منح Google رمزًا أوليًا. على سبيل المثال، قد تستخدم مدخل بطاقة الائتمان (المسؤول عن عملية الدمج) هذا الحقل لإعلام Google برمز الرفض الدقيق الذي تم تلقّيه من شبكة VISA. في هذه الحالة، ستكون scope هي "Visa" وسيكون rawCode هو أي قيمة تعرضها شبكة VISA.

هذه القيمة مطلوبة إذا لم تكن قيمة result SUCCESS.

رمز رد الأموال

تردّ رموز النتائج الفريدة.

عمليات التعداد
UNKNOWN_RESULT عدم ضبط هذه القيمة التلقائية مطلقًا
SUCCESS تم ردّ الأموال إليك بنجاح.
NO_MONEY_LEFT_ON_TRANSACTION تعذّر ردّ الأموال. يمثّل ذلك عادةً خطأً بين عملية الدمج وGoogle. ومن المفترض ألا تطلب Google استرداد مبلغ أكبر من القيمة الأصلية.
ACCOUNT_CLOSED

تم إغلاق الحساب المُضاف إلى عملية الدمج.

وسيؤدي عرض هذه القيمة إلى إغلاق أداة المستخدِم مع Google. سيضطر المستخدم إلى إضافة وسيلة جديدة من خلال تنفيذ عملية الربط مرة أخرى.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER

تم إغلاق حساب المستخدم مع إحدى عمليات الدمج، وتم الاستيلاء على الحساب المشتبه به.

وسيؤدي عرض هذه القيمة إلى إغلاق أداة المستخدِم مع Google. سيضطر المستخدم إلى إضافة وسيلة جديدة من خلال تنفيذ عملية الربط مرة أخرى.
ACCOUNT_CLOSED_FRAUD

تم إغلاق حساب المستخدم المرتبط بعملية الدمج بسبب الاحتيال.

وسيؤدي عرض هذه القيمة إلى إغلاق أداة المستخدِم مع Google. سيضطر المستخدم إلى إضافة وسيلة جديدة من خلال تنفيذ عملية الربط مرة أخرى.
ACCOUNT_ON_HOLD حساب المستخدم معلّق حاليًا ولا يمكنه قبول طلب ردّ الأموال، ولكن قد يتمكّن حساب المستخدم لاحقًا من قبول طلب ردّ الأموال. يمكن أن تطلب Google رد أموال آخر في المستقبل، ولكنها ستقدّم طلبًا جديدًا باستخدام requestId، لذا يجب اعتبار هذا الطلب مكتملاً.
REFUND_EXCEEDS_MAXIMUM_BALANCE لا يمكن معالجة عملية رد الأموال في الوقت الحالي، لأن ذلك سيؤدي إلى تجاوز رصيد المستخدم للحد الأقصى للمبلغ المسموح به. يمكن أن تطلب Google رد أموال آخر في المستقبل، ولكنها ستقدّم طلبًا جديدًا باستخدام requestId، لذا يجب اعتبار هذا الطلب مكتملاً.
REFUND_WINDOW_EXCEEDED لا يمكن معالجة طلب ردّ الأموال لأنّ الطلب يقع خارج الفترة المسموح بها لردّ الأموال.