Method: disburseFunds

Ödeme işleyici ile müşterinin hesabı arasında para transferi başlatır. Başlık içindeki requestId ve paymentIntegratorAccountId kombinasyonu idepotluk anahtarıdır ve bu işlemi benzersiz bir şekilde tanımlar. Bu işlemdeki tüm mutasyonlar, disburseFundsRequestId alanındaki requestId değerini doldurur.

Uç nokta, isteği işlerken bir hatayla karşılaşırsa bu uç noktadaki yanıt gövdesi ErrorResponse türünde olmalıdır.

Örnek istek:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "liUrreQY233839dfFFb24gaQM",
    "requestTimestamp": "1502220434778"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "upiDetails": {
      "vpa": "foo@icici"
  },
  "transactionDescription": "Google - Music",
  "currencyCode": "INR",
  "amount": "208000000"
}

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


{
  "responseHeader": {
    "responseTimestamp": "1481900013178"
  },
  "paymentIntegratorTransactionId": "aW50ZWdyYXRvciB0cmFuc2FjdGlvbiBpZA",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

HTTP isteği

POST https://www.integratorhost.example.com/v1/disburseFunds

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "transactionDescription": string,
  "currencyCode": string,
  "amount": string,

  // Union field destinationFopDetails can be only one of the following:
  "upiDetails": {
    object (UpiDetails)
  }
  // End of list of possible types for union field destinationFopDetails.
}
Alanlar
requestHeader

object (RequestHeader)

ZORUNLU: Tüm istekler için ortak başlık.
paymentIntegratorAccountId

string

ZORUNLU: Bu işlemle ilgili sözleşmeden doğan kısıtlamaları tanımlayan ödeme entegratörü hesap tanımlayıcısıdır.
transactionDescription

string

ZORUNLU: Müşterinin ekstresine eklenebilecek işlem açıklamasıdır. requestHeader içinde bulunan userLocale'e yerelleştirildi. Bu biçim haber verilmeden değiştirilebilir ve hiçbir zaman ayrıştırılmamalıdır.
currencyCode

string

ZORUNLU: ISO 4217 3 harfli para birimi kodu
amount

string (Int64Value format)

ZORUNLU: Para biriminin mikro cinsinden satın alma tutarı.

Birleştirme alanı destinationFopDetails.

destinationFopDetails şunlardan yalnızca biri olabilir:
upiDetails

object (UpiDetails)

İSTEĞE BAĞLI: UPI araçlarına özel ödeme ayrıntıları.

Yanıt gövdesi

Ödeme fonları yönteminin 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)
  },
  "paymentIntegratorTransactionId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
Alanlar
responseHeader

object (ResponseHeader)

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

string

ZORUNLU: Bu tanımlayıcı, entegratöre özeldir ve entegratör tarafından oluşturulur. Bu, entegrasyon uzmanının bu işlemi bildiği tanımlayıcıdır.

Kolaylık sağlaması açısından bu tanımlayıcı, havale ayrıntılarında belirtilmiştir
disburseFundsResult

object (DisburseFundsResult)

ZORUNLU: Ödeme parası çağrısının sonucu.

UpiDetails

Ödemenin yapılacağı UPI hesabıyla ilgili ayrıntılar.

JSON gösterimi 
{
  "vpa": string
}
Alanlar
vpa

string

ZORUNLU: UPI protokolü kullanılarak para taşımak için kullanılan, kullanıcının Sanal Ödeme Adresi (VPA). Örneğin, foo@icici.

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.