Method: disburseFundsResultNotification

disburseFunds yöntemi çağrısı yapıldıktan sonra ödeme sonucunu Google'a bildirin.

disburseFundsResult değeri, bu disburseFundsRequestId için aynı değil. Bu nedenle, değeri disburseFunds çağrısı sırasında döndürülen değerle aynı olmalıdır ve bu yönteme yapılan 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 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": "KcgwSKrV76eVNDUbsZ4UA3",
    "requestTimestamp": "1481852928293"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "disburseFundsRequestId": "awNaC510cefae3IJdNEvW2",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

Örnek bir yanıt:


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

HTTP isteği

POST https://vgw.googleapis.com/secure-serving/gsp/v1/disburseFundsResultNotification/: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,
  "disburseFundsRequestId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
Alanlar
requestHeader

object (RequestHeader)

ZORUNLU: Tüm istekler için ortak üstbilgi.
paymentIntegratorAccountId

string

ZORUNLU: Ödemenin yapıldığı ödeme entegratörü hesap tanımlayıcısı.
disburseFundsRequestId

string

GEREKLİ: Bu işlem için benzersiz bir tanımlayıcıdır. Bu, Google'ın bu isteğin ilişkili olduğu disburseFunds araması sırasında oluşturulan requestId.

Bu, en fazla 100 karakter uzunluğunda bir dizedir ve yalnızca "a-z", "A-Z", "0-9", ":", "-" ve "_" karakterlerini içerir.
disburseFundsResult

object (DisburseFundsResult)

GEREKLİ: Bu ödeme çağrısının sonucu.

Yanıt gövdesi

disburseFundsResultNotification 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 (DisburseFundsResultNotificationResultCode)
}
Alanlar
responseHeader

object (ResponseHeader)

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

enum (DisburseFundsResultNotificationResultCode)

GEREKLİ: Bu aramanın sonucu.

DisburseFundsSonuçu

Ödemenin nihai sonucuyla ilgili bilgiler.

JSON gösterimi 
{
  "disburseFundsResultCode": enum (DisburseFundsResultCode),
  "rawResult": {
    object (RawResult)
  },

  // Union field FailureDetail can be only one of the following:
  "transactionMaxLimit": string,
  "transactionMinLimit": string
  // End of list of possible types for union field FailureDetail.
}
Alanlar
disburseFundsResultCode

enum (DisburseFundsResultCode)

GEREKLİ: Bu ödemenin sonuç kodu.
rawResult

object (RawResult)

İSTEĞE BAĞLI: Bu ödemenin ham sonucu. Google'ın risk motorunu ve analizlerini bilgilendirmeye yardımcı olması için kullanılır. Reddetme kod eşleme durumlarında veriler bazen kaybolabilir. Entegratör, Google'a ham kod vermeyi tercih edebilir. Örneğin, kredi kartı ağ geçidi (entegratör), VISA ağından alınan tam reddetme kodunu Google'a bildirmek için bu alanı kullanabilir. Bu durumda, scope "vize", rawCode ise VISA ağının döndürdüğü değer olur.

result SUCCESS değilse bu değer gereklidir.

Birlik alanı FailureDetail.

FailureDetail aşağıdakilerden yalnızca biri olabilir:
transactionMaxLimit

string (Int64Value format)

İSTEĞE BAĞLI: disburseFundsResultCode DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT ise bu, izin verilen maksimum işlemin değeridir. Bu, yapılandırılmış, kullanıcılara yönelik mesajlaşma ve reddetme oranı analizi için kullanılır.

Bu tutar, orijinal disburseFunds yöntem çağrısıyla aynı currencyCode değerinin mikro değeridir.
transactionMinLimit

string (Int64Value format)

İSTEĞE BAĞLI: disburseFundsResultCode DISBURSEMENT_UNDER_TRANSACTION_LIMIT ise bu, izin verilen minimum işlemin değeridir. Bu, yapılandırılmış, kullanıcılara yönelik mesajlaşma ve reddetme oranı analizi için kullanılır.

Bu tutar, orijinal disburseFunds yöntem çağrısıyla aynı currencyCode değerinin mikro değeridir.

DisburseFundsSonuç Kodu

Ödeme para çağrısı için sonuç kodları.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri hiçbir zaman ayarlama!
SUCCESS Ödeme başarılı oldu.
DISBURSEMENT_UNDER_TRANSACTION_LIMIT İstenen ödeme tutarı, entegratörün işlem başına minimum tutarını karşılamıyor. Bu kod kullanılıyorsa transactionMinLimit alanını, kullanıcı mesajları için minimum işlem tutarı ile doldurun.
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT İstenen ödeme tutarı, entegrasyon uzmanının işlem başına maksimum sınırını aşıyor. Bu kod kullanılıyorsa transactionMaxLimit alanına kullanıcı mesajlarıyla ilgili işlemler için işlem sınırı girin.
ACCOUNT_CLOSED Kullanıcının entegratörle ilişkili olduğu hesap kapatıldı. Bu iade değeri, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı yeni bir araç eklemek zorunda kalacaktır.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER Kullanıcının entegratörle hesabı kapatıldı. Hesabın ele geçirildiğinden şüpheleniliyor. Bu iade değeri, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı 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 iade değeri, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı yeni bir araç eklemek zorunda kalacaktır.
ACCOUNT_ON_HOLD Kullanıcının hesabı beklemede.

Ham Sonuçlar

Ham sonuç nesnesi.

JSON gösterimi 
{
  "scope": string,
  "rawCode": string
}
Alanlar
scope

string

İSTEĞE BAĞLI: hamCode'un kapsamı boş olabilir.
rawCode

string

GEREKLİ: Entegratörden veya içindeki alt sistemlerden alınan ham kod.

DisburseFundsSonuç BildirimiSonuçKodu

disburseFundsResultNotification yönteminin sonuç kodları.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri hiçbir zaman ayarlama!
SUCCESS Bildirim başarıyla işlendi.