Method: disburseFundsResultNotification

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

disburseFundsResult değeri, bu disburseFundsRequestId için ihtiyatlı olduğundan 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 sonraki bir ç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": "KcgwSKrV76eVNDUbsZ4UA3",
    "requestTimestamp": "1481852928293"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "disburseFundsRequestId": "awNaC510cefae3IJdNEvW2",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

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


{
  "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 verileri 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 başlık.
paymentIntegratorAccountId

string

ZORUNLU: Ödemenin gerçekleştiği ödeme entegratörü hesap kimliği.
disburseFundsRequestId

string

ZORUNLU: Bu işlem için benzersiz bir tanımlayıcı. Bu, isteğin ilişkili olduğu disburseFunds çağrısı sırasında Google tarafından oluşturulan requestId öğesidir.

Bu dize, en fazla 100 karakter uzunluğunda olabilir ve sadece "a-z", "A-Z", "0-9", ":", "-" ve "_" karakterlerini içerir.
disburseFundsResult

object (DisburseFundsResult)

ZORUNLU: 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)

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

DisburseFundsResult

Bir ö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)

ZORUNLU: Bu ödemenin sonuç kodu.
rawResult

object (RawResult)

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

result, SUCCESS değilse bu değer zorunludur.

Birleştirme alanı FailureDetail.

FailureDetail şunlardan 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 özellik, kullanıcıya yönelik yapılandırılmış mesajlar ve reddetme oranı analizi için kullanılır.

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

string (Int64Value format)

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

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

DisburseFundsResultCode

Para harcama araması için sonuç kodları.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri asla ayarlamayın.
SUCCESS Ödeme başarılı.
DISBURSEMENT_UNDER_TRANSACTION_LIMIT İstenen ödeme tutarı, entegrasyon uzmanının işlem başına minimum tutarını karşılamıyor. Bu kod kullanılıyorsa kullanıcı mesajları için transactionMinLimit alanını minimum işlem tutarıyla 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 kullanıcı mesajlaşması için transactionMaxLimit alanını işlem sınırıyla doldurun.
ACCOUNT_CLOSED Kullanıcının entegrasyon uzmanındaki hesabı kapatıldı. Bu döndürülen değer, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı, 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 döndürülen değer, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı, yeni bir araç eklemeye zorlanır.
ACCOUNT_CLOSED_FRAUD Kullanıcının entegrasyon uzmanındaki hesabı sahtekarlık nedeniyle kapatıldı. Bu döndürülen değer, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı, yeni bir araç eklemeye zorlanır.
ACCOUNT_ON_HOLD Kullanıcının hesabı askıya alındı.

RawResult

Ham sonuç nesnesi.

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

string

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

string

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

DisburseFundsResultNotificationResultCode

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

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri asla ayarlamayın.
SUCCESS Bildirim başarıyla işlendi.