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
türünde olur.ErrorResponse
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
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.ErrorResponse
Ö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 ( |
Alanlar | |
---|---|
requestHeader |
ZORUNLU: Tüm istekler için ortak üstbilgi. |
paymentIntegratorAccountId |
GEREKLİ: Geri ödemenin yapıldığı ödeme entegrasyonu hesap tanımlayıcısı. |
refundRequestId |
GEREKLİ: |
refundResult |
GEREKLİ: Bu geri ödemenin sonucu. |
paymentIntegratorRefundId |
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 ( |
Alanlar | |
---|---|
responseHeader |
ZORUNLU: Tüm yanıtlar için ortak başlık. |
result |
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ı. |