Method: refundResultNotification

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

Geri ödemeler, refund yöntemi çağrısı sırasında eşzamanlı olarak gerçekleştirilmelidir. Ancak bu yöntem, eşzamanlı işlemin çağrıyı gerçekleştirdikten sonra başarısız olmasına rağmen sonuç döndürmeden önce Google'a hızlı bir yedekleme sinyali sağlar. Bu sayede Google, yeniden deneme için gelecekte yaşanabilecek gecikmelerden yararlanır.

refundResult değeri, bu refundRequestId için aynı olmadığından, bu yönteme yapılan bir sonraki çağrıyla değeri 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 bir HTTP 200 döndürmezse bu sorguya verilen yanıtlar boş olabilir. Saldırganın, diğer entegratörlerin ödeme entegratörü hesap tanımlayıcılarını anlamasına yardımcı olmak için açık bir ErrorResponse açıklaması kullanılabileceği yanıt gövdesi boş. Bu durumlarda, imzalama anahtarının eşleşmediği, ödeme entegratör tanımlayıcısının bulunmadığı veya şifreleme anahtarının bilinmediği durumlarda bu yöntem boş gövdeye sahip 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 bir 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:


{
  "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 veriler 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 üstbilgi.
paymentIntegratorAccountId

string

GEREKLİ: Geri ödemenin yapıldığı ödeme entegrasyonu hesap tanımlayıcısı.
refundRequestId

string

GEREKLİ: refund geri ödeme yöntemi çağrıldığında requestId alanı tarafından oluşturulan bu geri ödeme için benzersiz tanımlayıcı.
refundResult

enum (RefundResultCode)

GEREKLİ: Bu geri ödemenin sonucu.
paymentIntegratorRefundId

string

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

Bu tanımlayıcı, size kolaylık sağlamak için havale ayrıntılarına dahil edilmiş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)

GEREKLİ: Bu aramanın sonucu.

Geri ÖdemeSonuçKodu

Benzersiz sonuç, geri ödemeleri kodlar.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri hiçbir zaman ayarlama!
SUCCESS Başarılı geri ödeme.
NO_MONEY_LEFT_ON_TRANSACTION Geri ödeme yapılamadı. İşlemde kalan para yok. Bu, genellikle entegratör ve Google arasındaki hatayı temsil eder. Google, orijinal yakalamadan daha yüksek bir tutar için geri ödeme isteğinde bulunmamalıdır.
ACCOUNT_CLOSED

Entegratörle bekletilen 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ışına tekrar giderek yeni bir araç eklemek zorunda kalacaktır.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER

Kullanıcının entegratörle hesabı kapatıldı. Bu kullanıcının hesabın ele geçirildiğinden şüpheleniliyor.

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ışına tekrar giderek yeni bir araç eklemek zorunda kalacaktır.
ACCOUNT_CLOSED_FRAUD

Kullanıcının entegratörle paylaştığı hesap, 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ışına tekrar giderek yeni bir araç eklemek zorunda kalacaktır.
ACCOUNT_ON_HOLD Kullanıcının hesabı şu anda beklemededir ve geri ödemeyi kabul edemez. Ancak kullanıcının hesabı daha sonra geri ödemeyi kabul edebilir. Google gelecekte yeni bir geri ödeme isteğinde bulunabilir ancak yeni bir requestId isteği göndereceğinden bu istek tamamlanmış olarak kabul edilmelidir.
REFUND_EXCEEDS_MAXIMUM_BALANCE Kullanıcı bakiyesinin izin verilen maksimum tutarı aşmasına neden olacağından geri ödeme işlemi şu anda gerçekleştirilemiyor. Google gelecekte yeni bir geri ödeme isteğinde bulunabilir ancak yeni bir requestId isteği göndereceğinden bu istek tamamlanmış olarak kabul edilmelidir.
REFUND_WINDOW_EXCEEDED İstek, izin verilen geri ödeme süresinin dışında olduğundan geri ödeme işlenemiyor.

RefundResultNotificationSonuçKodu

refundResultNotification yönteminin sonuç kodları.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri hiçbir zaman ayarlama!
SUCCESS Geri ödeme sonucu bildirimi başarılı.