Method: disburseFundsResultNotification

Beri tahu Google tentang hasil pencairan setelah panggilan metode disburseFunds dilakukan.

Nilai disburseFundsResult bersifat idempoten untuk disburseFundsRequestId ini, sehingga nilainya harus sama dengan nilai yang ditampilkan selama panggilan disburseFunds dan tidak dapat diubah oleh panggilan berikutnya ke metode ini.

Jika endpoint mengalami error saat memproses permintaan, respons dari endpoint ini akan berjenis ErrorResponse.

Respons terhadap kueri ini mungkin kosong jika metode ini tidak menampilkan HTTP 200. Isi respons kosong jika ErrorResponse dengan deskripsi yang jelas dapat digunakan untuk membantu penyerang memahami ID akun integrator pembayaran dari integrator lainnya. Dalam situasi ini, jika kunci penandatanganan tidak cocok, ID integrator pembayaran tidak ditemukan, atau kunci enkripsi tidak diketahui, metode ini akan menampilkan HTTP 404 dengan isi kosong. Jika tanda tangan permintaan dapat diverifikasi, informasi tambahan terkait error akan ditampilkan dalam isi respons.

Contoh permintaan terlihat seperti ini:


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

Contoh respons terlihat seperti ini:


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

Permintaan HTTP

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

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

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

object (RequestHeader)

DIPERLUKAN: Header umum untuk semua permintaan.
paymentIntegratorAccountId

string

DIPERLUKAN: ID akun integrator pembayaran tempat pencairan dilakukan.
disburseFundsRequestId

string

DIPERLUKAN: ID unik untuk transaksi ini. Ini adalah requestId yang dihasilkan oleh Google selama panggilan disburseFunds yang terkait dengan permintaan ini.

Ini adalah string dengan panjang maksimal 100 karakter dan hanya berisi karakter "a-z", "A-Z", "0-9", ":", "-", dan "_".
disburseFundsResult

object (DisburseFundsResult)

DIPERLUKAN: Hasil dari panggilan dana pencairan ini.

Isi respons

Objek respons untuk metode disburseFundsResultNotification.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (DisburseFundsResultNotificationResultCode)
}
Kolom
responseHeader

object (ResponseHeader)

DIPERLUKAN: Header umum untuk semua respons.
result

enum (DisburseFundsResultNotificationResultCode)

REQUIRED: Hasil dari panggilan ini.

HasilDisburseFunds

Informasi tentang hasil akhir pencairan.

Representasi 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.
}
Kolom
disburseFundsResultCode

enum (DisburseFundsResultCode)

DIPERLUKAN: Kode hasil pencairan ini.
rawResult

object (RawResult)

OPSIONAL: Hasil mentah dari pencairan ini. Digunakan untuk membantu menginformasikan mesin risiko dan analisis Google. Dalam situasi pemetaan–kode yang ditolak, terkadang data hilang. Integrator dapat memilih untuk memberikan kode mentah kepada Google. Misalnya, gateway kartu kredit (integrator) dapat menggunakan kolom ini untuk menyampaikan kepada Google kode penolakan persis yang diterima dari jaringan VISA. Dalam hal ini, scope akan menjadi "visa" dan rawCode akan menjadi apa pun yang ditampilkan jaringan VISA.

Nilai ini wajib jika result bukan SUCCESS.

Kolom union FailureDetail.

FailureDetail hanya dapat berupa salah satu dari berikut:
transactionMaxLimit

string (Int64Value format)

OPSIONAL: Jika disburseFundsResultCode adalah DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT, ini adalah nilai transaksi maksimum yang diizinkan. Mode ini digunakan untuk analisis pesan dan rasio penolakan yang terstruktur dan digunakan pengguna.

Jumlah ini adalah mikro currencyCode yang sama dengan panggilan metode disburseFunds asli.
transactionMinLimit

string (Int64Value format)

OPSIONAL: Jika disburseFundsResultCode adalah DISBURSEMENT_UNDER_TRANSACTION_LIMIT, ini adalah nilai transaksi minimum yang diizinkan. Mode ini digunakan untuk analisis pesan dan rasio penolakan yang terstruktur dan digunakan pengguna.

Jumlah ini adalah mikro currencyCode yang sama dengan panggilan metode disburseFunds asli.

DisburseFundsResultCode

Kode hasil untuk panggilan dana pencairan.

Enumerasi
UNKNOWN_RESULT Jangan pernah menetapkan nilai default ini.
SUCCESS Pencairan berhasil.
DISBURSEMENT_UNDER_TRANSACTION_LIMIT Jumlah pencairan yang diminta tidak memenuhi jumlah minimum transaksi per integrator. Jika kode ini digunakan, isi kolom transactionMinLimit dengan jumlah transaksi minimum untuk tujuan pesan pengguna.
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT Jumlah pencairan yang diminta melebihi batas maksimum per transaksi untuk integrator. Jika kode ini digunakan, isi kolom transactionMaxLimit dengan batas transaksi untuk tujuan pesan pengguna.
ACCOUNT_CLOSED Akun pengguna yang dibekukan dengan integrator telah ditutup. Nilai pengembalian ini akan menyebabkan instrumen pengguna ditutup dengan Google. Pengguna akan dipaksa untuk menambahkan instrumen baru.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER Akun pengguna dengan integrator telah ditutup, dan akun yang dicurigai akan mengambil alih. Nilai pengembalian ini akan menyebabkan instrumen pengguna ditutup dengan Google. Pengguna akan dipaksa untuk menambahkan instrumen baru.
ACCOUNT_CLOSED_FRAUD Akun pengguna yang ditahan oleh integrator telah ditutup karena penipuan. Nilai pengembalian ini akan menyebabkan instrumen pengguna ditutup dengan Google. Pengguna akan dipaksa untuk menambahkan instrumen baru.
ACCOUNT_ON_HOLD Akun pengguna ditangguhkan.

HasilMentah

Objek hasil mentah.

Representasi JSON 
{
  "scope": string,
  "rawCode": string
}
Kolom
scope

string

OPTIONAL: Cakupan rawCode, boleh kosong.
rawCode

string

DIPERLUKAN: Kode mentah dari integrator atau subsistem di dalamnya.

DisburseFundsResultNotificationResultCode

Kode hasil untuk metode disburseFundsResultNotification.

Enumerasi
UNKNOWN_RESULT Jangan pernah menetapkan nilai default ini.
SUCCESS Notifikasi berhasil diproses.