Method: disburseFundsResultNotification

Powiadom Google o wyniku wypłaty po wywołaniu metody disburseFunds.

Wartość disburseFundsResult jest idempotentna dla tego parametru disburseFundsRequestId, więc musi być identyczna z wartością zwracaną podczas wywołania disburseFunds i nie może zostać zmieniona przez kolejne wywołanie tej metody.

Jeśli podczas przetwarzania żądania punkt końcowy napotka błąd, odpowiedź z tego punktu końcowego będzie typu ErrorResponse.

Jeśli ta metoda nie zwraca kodu HTTP 200, odpowiedzi na to zapytanie mogą być puste. Treść odpowiedzi jest pusta w sytuacjach, gdy można wykorzystać pole ErrorResponse z jasnym opisem, aby ułatwić osobie przeprowadzającej atak rozpoznanie identyfikatora konta integratora płatności innych integratorów. W takich sytuacjach, gdy klucz podpisywania nie pasuje, nie znaleziono identyfikatora integratora płatności lub klucz szyfrowania jest nieznany, ta metoda zwróci błąd HTTP 404 z pustą treścią. Jeśli podpis żądania można zweryfikować, dodatkowe informacje dotyczące błędu zostaną zwrócone w treści odpowiedzi.

Przykładowe żądanie wygląda tak:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "KcgwSKrV76eVNDUbsZ4UA3",
    "requestTimestamp": "1481852928293"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "disburseFundsRequestId": "awNaC510cefae3IJdNEvW2",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

Przykładowa odpowiedź wygląda tak:


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

Żądanie HTTP

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

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "disburseFundsRequestId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
Pola
requestHeader

object (RequestHeader)

WYMAGANE: wspólny nagłówek dla wszystkich żądań.
paymentIntegratorAccountId

string

WYMAGANE: identyfikator konta integratora płatności, na którym miała miejsce wypłata.
disburseFundsRequestId

string

WYMAGANE: unikalny identyfikator transakcji. To jest requestId wygenerowany przez Google podczas rozmowy w usłudze disburseFunds, z którą jest powiązane to żądanie.

Jest to ciąg o maksymalnej długości 100 znaków, który zawiera tylko znaki „a–z”, „A–Z”, „0–9”, „:”, „-” i „_”.
disburseFundsResult

object (DisburseFundsResult)

WYMAGANE: wynik tego wywołania wypłaty środków.

Treść odpowiedzi

Obiekt odpowiedzi dla metody disburseFundsResultNotification.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (DisburseFundsResultNotificationResultCode)
}
Pola
responseHeader

object (ResponseHeader)

WYMAGANE: wspólny nagłówek wszystkich odpowiedzi.
result

enum (DisburseFundsResultNotificationResultCode)

WYMAGANE: wynik tego wywołania.

DisburseFundsResult

Informacje o ostatecznym wyniku wypłaty.

Zapis JSON 
{
  "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.
}
Pola
disburseFundsResultCode

enum (DisburseFundsResultCode)

WYMAGANE: kod wyniku wypłaty.
rawResult

object (RawResult)

OPCJONALNIE: nieprzetworzony wynik wypłaty. Dane są używane do przekazywania informacji do programu wykrywającego zagrożenia Google i analiz. W przypadku mapowania kodu odrzucenia czasami dochodzi do utraty danych. Integrator może przekazać Google nieprzetworzony kod. Brama karty kredytowej (integrator) może na przykład użyć tego pola, by przekazać Google dokładny kod odrzucenia otrzymany z sieci VISA. W tym przypadku scope będzie to „wiza”. a rawCode to wszystko, co zwróciła sieć VISA.

Ta wartość jest wymagana, jeśli result nie ma wartości SUCCESS.

Pole sumy FailureDetail.

FailureDetail może mieć tylko jedną z tych wartości:
transactionMaxLimit

string (Int64Value format)

OPCJONALNIE: jeśli disburseFundsResultCode ma wartość DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT, to jest wartość maksymalnej dozwolonej transakcji. Służy do analizy ustrukturyzowanego przesyłania wiadomości dla użytkowników i analizy współczynnika odrzuceń.

Ta wartość to micros tej samej wartości currencyCode co pierwotne wywołanie metody disburseFunds.
transactionMinLimit

string (Int64Value format)

OPCJONALNIE: jeśli disburseFundsResultCode to DISBURSEMENT_UNDER_TRANSACTION_LIMIT, jest to wartość minimalnej dozwolonej transakcji. Służy do analizy ustrukturyzowanego przesyłania wiadomości dla użytkowników i analizy współczynnika odrzuceń.

Ta wartość to micros tej samej wartości currencyCode co pierwotne wywołanie metody disburseFunds.

DisburseFundsResultCode

Kody wyników rozmowy dotyczącej wypłaty środków.

Wartości w polu enum
UNKNOWN_RESULT Nigdy nie ustawiaj tej wartości domyślnej.
SUCCESS Wypłata została zrealizowana.
DISBURSEMENT_UNDER_TRANSACTION_LIMIT Żądana kwota wypłaty nie spełnia minimalnej kwoty wypłaty określonej przez integratora na transakcję. Jeśli ten kod jest używany, w polu transactionMinLimit wpisz minimalną kwotę transakcji na potrzeby wiadomości dla użytkowników.
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT Żądana kwota wypłaty przekracza maksymalny limit na transakcję integratora. Jeśli ten kod jest używany, w polu transactionMaxLimit wpisz limit transakcji na potrzeby wiadomości dla użytkowników.
ACCOUNT_CLOSED Konto użytkownika powiązane z integratorem zostało zamknięte. Ta wartość zwrotna spowoduje zamknięcie instrumentu użytkownika przez Google. Użytkownik będzie musiał dodać nowy instrument.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER Konto użytkownika integratora zostało zamknięte. Istnieje podejrzenie przejęcia konta. Ta wartość zwrotna spowoduje zamknięcie instrumentu użytkownika przez Google. Użytkownik będzie musiał dodać nowy instrument.
ACCOUNT_CLOSED_FRAUD Konto użytkownika powiązane z integratorem zostało zamknięte z powodu oszustwa. Ta wartość zwrotna spowoduje zamknięcie instrumentu użytkownika przez Google. Użytkownik będzie musiał dodać nowy instrument.
ACCOUNT_ON_HOLD Konto użytkownika jest wstrzymane.

RawResult

Obiekt nieprzetworzonego wyniku.

Zapis JSON 
{
  "scope": string,
  "rawCode": string
}
Pola
scope

string

OPTIONAL: zakres kodu rawCode może być pusty.
rawCode

string

WYMAGANE: nieprzetworzony kod z integratora lub jego podsystemów.

DisburseFundsResultNotificationResultCode

Kody wyników dla metody disburseFundsResultNotification.

Wartości w polu enum
UNKNOWN_RESULT Nigdy nie ustawiaj tej wartości domyślnej.
SUCCESS Powiadomienie zostało przetworzone.