الكائن: واجهة المصادقة

نص الاستجابة

الكائن الذي تم إرساله أثناء استجابة المصادقة

في ما يلي مثال على استجابة JSON بتنسيق نص واضح:

  {
    "associationId": "88ydEE-ioiwe==",
    "requestId": "375dhjf9-Uydd="
  }

يتم تشفير AuthenticationResponse وتوقيعه باستخدام PGP أو JWE+JWS. بالإضافة إلى ذلك، تكون هذه القيمة مشفّرة بترميز base64 آمن على الويب. يُشار إلى ترميز Base64UrlEncode أدناه باسم Base64UrlEncode. بعبارة أخرى، يجب تمرير نسخة ملف JSON النصية الواضحة من AuthenticationRequest من خلال الدوالّ التالية:

Base64UrlEncode(
  PGPSignAndEncrypt(
    '{"associationId": "88ydEE-ioiwe==", "requestId": "375dhjf9-Uydd="}'
  )
)

أو

Base64UrlEncode(
  JWSignAndEncrypt(
    '{"associationId": "88ydEE-ioiwe==", "requestId": "375dhjf9-Uydd="}'
  )
)
تمثيل JSON
{
  "associationId": string,
  "requestId": string,
  "authenticationResult": {
  object (AuthenticationResult)  }
  }
الحقول
associationId

string

ردّت جهة تكامل عمليات الدفع هذه الرسالة إلى Google. يسمح ذلك لـ Google بالتحقّق من أنّ associationId الذي تم إرجاعه هو الgspAssociationId نفسه الذي تم تمريره. يجب توفير هذه السمة إذا كانت مضمَّنة في الطلب.

requestId

string

مطلوبة: يعيد مُدمِج الدفعات إرسالها إلى Google. ويسمح ذلك لشركة Google بمنع هجمات إعادة التشغيل.

authenticationResult

object (AuthenticationResult)

هي نتيجة المصادقة. بالنسبة إلى عمليات الدفع التي لا تتضمّن طلبًا لاحقًا إلى منظومة دمج الدفعات بعد اكتمال المصادقة، يجب تضمين النتيجة في الاستجابة لضمان سلامة النتيجة.

AuthenticationResult

تمثيل JSON
{
  // Union field result can be only one of the following:
  "success": {
  object (Empty)
  },
  "cancelled": {
  object (Empty)
  },
  "fatalError": {
  object (Empty)
  }
  // End of list of possible types for union field result.
  }
الحقول

حقل الربط result

يمكن أن يكون result واحدًا فقط مما يلي:

success

object (Empty)

تمت المصادقة بنجاح.

cancelled

object (Empty)

ألغى المستخدم التدفق يدويًا ويجب إلغاء التدفق.

fatalError

object (Empty)

تعذّرت المصادقة لسبب خطير ويجب إيقاف الإجراء.