Method: disburseFunds

Ödeme işleyici ile müşterinin hesabı arasında para aktarımı başlatır. Başlık içindeki requestId ve paymentIntegratorAccountId kombinasyonu kimlik anahtarıdır ve bu işlemi benzersiz ş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ç noktanın yanıt gövdesi ErrorResponse türünde olmalıdır.

Örnek bir istek şu şekilde görünür:


{
  "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 şöyle görünür:


{
  "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ıyla birlikte veriler 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 kimliğidir.
transactionDescription

string

ZORUNLU: Müşterinin ekstresine eklenebilecek işlem açıklamasıdır. requestHeader içinde bulunan userLocale'ye göre yerelleştirilmiş. Bu biçim önceden haber verilmeksizin 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ı.

destinationFopDetails alanı.

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öntemiyle ilgili 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, entegratörü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ına eklenmiştir.
disburseFundsResult

object (DisburseFundsResult)

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

UpiDetails

Ödeme yapılacak 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 motoru ve analizlerinin bilgilendirilmesine yardımcı olmak için kullanılır. Reddetme kodu eşleme durumlarında bazen veriler kaybolur. Entegratör, Google'a ham bir kod vermeyi tercih edebilir. Örneğin, bir kredi kartı ağ geçidi (entegre edici) bu alanı, VISA ağından alınan reddetme kodunu aynen Google'a iletmek için kullanabilir. Bu durumda, scope "vize", rawCode ise VISA ağının döndürdüğü değer olacaktır.

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

FailureDetail alanı.

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, yapılandırılmış, kullanıcıya yönelik mesajlaşma ve ret oranı analizi için kullanılır.

Bu miktar, orijinal disburseFunds yöntem çağrısıyla aynı currencyCode değerine göre mikro'dur.
transactionMinLimit

string (Int64Value format)

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

Bu miktar, orijinal disburseFunds yöntem çağrısıyla aynı currencyCode değerine göre mikro'dur.

DisburseFundsResultCode

Ödeme yardımı araması için sonuç kodları.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri hiçbir zaman ayarlamayın.
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ırsa kullanıcının mesajlaşma amacıyla transactionMinLimit alanını minimum işlem tutarıyla doldurun.
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT İstenen ödeme tutarı, entegratörün işlem başına maksimum sınırını aşıyor. Bu kod kullanılırsa kullanıcının mesajlaşma amacıyla transactionMaxLimit alanını işlem sınırıyla doldurun.
ACCOUNT_CLOSED Kullanıcının entegratörde bulunan hesabı kapatıldı. Bu döndürülen değer, kullanıcının aracının Google tarafından kapatılmasına neden olur. Kullanıcı yeni bir araç eklemeye zorlanır.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER Kullanıcının entegratördeki hesabı kapatıldı ve hesabın ele geçirildiğinden şüpheleniliyor. Bu döndürülen değer, kullanıcının aracının Google tarafından kapatılmasına neden olur. Kullanıcı yeni bir araç eklemeye zorlanır.
ACCOUNT_CLOSED_FRAUD Kullanıcının entegratörde tutulan hesabı sahtekarlık nedeniyle kapatıldı. Bu döndürülen değer, kullanıcının aracının Google tarafından kapatılmasına neden olur. Kullanıcı yeni bir araç eklemeye zorlanır.
ACCOUNT_ON_HOLD Kullanıcının hesabı beklemede.

RawResult

Ham sonuç nesnesi.

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

string

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

string

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