Method: refundResultNotification

refund yöntemi çağrısı yapıldıktan sonra geri ödeme işleminin sonucunu Google'a bildirin.

Geri ödemeler, refund yöntem çağrısı sırasında eşzamanlı olarak işlenmelidir ancak bu yöntem, eşzamanlı çağrının işlemi gerçekleştirdikten sonra başarısız olması ancak sonuç döndürmeden başarısız olması ihtimaline karşı Google'a hızlı bir yedekleme sinyali sağlar. Bu, Google'ın gelecekteki bir yeniden deneme için zaman planlaması yaparken neden olduğu gecikmeyi önler.

refundResult değeri, bu refundRequestId için ihtiyatlı olduğundan değeri, bu yönteme yapılacak bir sonraki çağrıyla değiştirilemez.

Uç nokta, isteği işlerken bir hatayla karşılaşırsa bu uç noktadan gelen yanıt ErrorResponse türünde olur.

Bu yöntem HTTP 200 döndürmezse bu sorguya verilen yanıtlar boş olabilir. Açık açıklamaya sahip bir ErrorResponse, saldırganların diğer entegratörlerin ödeme entegrasyon hesap tanımlayıcılarını anlamasına yardımcı olmak için kullanılabileceği durumlarda yanıt gövdesi boştur. İmzalama anahtarının eşleşmediği, ödeme entegratörü tanımlayıcısının bulunamadığı veya şifreleme anahtarının bilinmediği durumlarda bu yöntem, gövdesi boş bir HTTP 404 döndürür. İstek imzası doğrulanabilirse yanıt gövdesinde hatayla ilgili ek bilgiler döndürülür.

Örnek istek:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "HsKv5pvtQKTtz7rdcw1YqE",
    "requestTimestamp": "1481855928301"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "refundRequestId": "hH1T32PI86CpKwjuf6oD2r",
  "paymentIntegratorRefundId": "invisi/Id::xx__1243",
  "refundResult": "SUCCESS"
}

Örnek bir yanıt aşağıdaki gibidir:


{
  "responseHeader": {
    "responseTimestamp": "1481855928376"
  },
  "result": "SUCCESS"
}

HTTP isteği

POST https://vgw.googleapis.com/secure-serving/gsp/v1/refundResultNotification/:PIAID

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "refundRequestId": string,
  "refundResult": enum (RefundResultCode),
  "paymentIntegratorRefundId": string
}
Alanlar
requestHeader

object (RequestHeader)

ZORUNLU: Tüm istekler için ortak başlık.
paymentIntegratorAccountId

string

ZORUNLU: Geri ödemenin yapıldığı ödeme entegratörü hesap kimliği.
refundRequestId

string

ZORUNLU: refund yöntemi çağrıldığında requestId alanı tarafından belirlenen, bu geri ödeme için benzersiz tanımlayıcı.
refundResult

enum (RefundResultCode)

ZORUNLU: Bu geri ödemenin sonucu.
paymentIntegratorRefundId

string

ZORUNLU: Bu tanımlayıcı, entegratöre özeldir ve entegratör tarafından oluşturulur. Bu, entegrasyon uzmanının bu geri ödemeyi bildiği tanımlayıcıdır.

Kolaylık sağlaması açısından bu tanımlayıcı, havale ayrıntılarında belirtilmiştir

Yanıt gövdesi

refundResultNotification yöntemi için yanıt nesnesi.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (RefundResultNotificationResultCode)
}
Alanlar
responseHeader

object (ResponseHeader)

ZORUNLU: Tüm yanıtlar için ortak başlık.
result

enum (RefundResultNotificationResultCode)

ZORUNLU: Bu çağrının sonucu.

RefundResultCode

Benzersiz sonuç kodları geri ödemeler.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri asla ayarlamayın.
SUCCESS Geri ödeme başarılı.
NO_MONEY_LEFT_ON_TRANSACTION Geri ödeme başarısız oldu, işlemde para kalmadı. Bu genellikle entegrasyon uzmanı ile Google arasındaki hatayı temsil eder. Google, orijinal yakalamadan daha yüksek bir tutarın geri ödenmesini istememelidir.
ACCOUNT_CLOSED

İntegratörde bulunan hesap kapatıldı.

Bu değerin döndürülmesi, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı, ilişkilendirme akışından tekrar geçerek yeni bir araç eklemeye zorlanır.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER

Kullanıcının entegrasyon uzmanındaki hesabı kapatıldı ve şüpheli hesap devralındı.

Bu değerin döndürülmesi, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı, ilişkilendirme akışından tekrar geçerek yeni bir araç eklemeye zorlanır.
ACCOUNT_CLOSED_FRAUD

Kullanıcının entegrasyon uzmanındaki hesabı sahtekarlık nedeniyle kapatıldı.

Bu değerin döndürülmesi, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı, ilişkilendirme akışından tekrar geçerek yeni bir araç eklemeye zorlanır.
ACCOUNT_ON_HOLD Kullanıcının hesabı şu anda beklemede ve geri ödemeyi kabul edemez, ancak kullanıcının hesabı daha sonra geri ödemeyi kabul edebilir. Google gelecekte başka bir geri ödeme isteğinde bulunabilir ancak yeni bir requestId ile bunu talep eder. Bu nedenle, bu istek tamamlanmış sayılır.
REFUND_EXCEEDS_MAXIMUM_BALANCE Geri ödeme, kullanıcının bakiyesinin izin verilen maksimum tutarı aşmasına neden olacağından şu anda işleme alınamıyor. Google gelecekte başka bir geri ödeme isteğinde bulunabilir ancak yeni bir requestId ile bunu talep eder. Bu nedenle, bu istek tamamlanmış sayılır.
REFUND_WINDOW_EXCEEDED İstek, izin verilen geri ödeme süresinin dışında olduğu için geri ödeme işlenemiyor.

RefundResultNotificationResultCode

refundResultNotification yöntemi için sonuç kodları.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri asla ayarlamayın.
SUCCESS Geri ödeme sonucu bildirimi başarılı oldu.