Method: asynchronousCapture

Müşterinin hesabı ile entegratör arasında bir para transferi işleminin başlatılmasını tetikler. Entegratör, isteği onaylamalı ve yakalamanın tamamlanması için gereken işlemleri yapmalıdır (ör. kullanıcıdan PIN alma). Entegratör, CaptureResult Notification API'yi çağırarak yakalamanın nihai sonucunu Google'a bildirir.

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 değişiklikler (geri ödemeler), captureRequestId 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": 1,
      "revision": 0
    },
    "requestId": "bWVyY2hhbnQgdHJhbnNhY3Rpb24gaWQ",
    "requestTimestamp": "1502220196077"
  },
  "paymentIntegratorAccountId": "InvisiCashIN_INR",
  "upiDetails": {
      "vpa": "foo@icici"
  },
  "transactionDescription": "Google - Music",
  "currencyCode": "INR",
  "amount": "728000000"
}

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


{
  "responseHeader": {
    "responseTimestamp": "1481900013178"
  },
  "result": "ACKNOWLEDGED",
  "paymentIntegratorTransactionId": "aW50ZWdyYXRvciB0cmFuc2FjdGlvbiBpZA"
}

HTTP isteği

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

İ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 fopDetails can be only one of the following:
  "upiDetails": {
    object (UpiDetails)
  },
  "tokenizedInstrumentDetails": {
    object (TokenizedInstrumentDetails)
  }
  // End of list of possible types for union field fopDetails.
}
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: Satın alma tutarının, para biriminin mikro cinsinden değeri.

Birleştirme alanı fopDetails.

fopDetails şunlardan yalnızca biri olabilir:
upiDetails

object (UpiDetails)

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

object (TokenizedInstrumentDetails)

İSTEĞE BAĞLI: Token atanmış araçlara özel ödeme ayrıntıları.

Yanıt gövdesi

Yakalama 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,
  "result": enum (AsynchronousCaptureResultCode)
}
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
result

enum (AsynchronousCaptureResultCode)

ZORUNLU: Eşzamansız yakalama çağrısının sonucu.

UpiDetails

Verinin görüntülenebileceği 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.

TokenizedInstrumentDetails

Görüntünün alındığı hesapla ilgili ayrıntılar.

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

string

ZORUNLU: Bu, her iki şirketin de birbirleri arasındaki satın alma işlemlerinde hesabı tanımlamak için kullanacağı jetondur.

AsynchronousCaptureResultCode

Eşzamansız Yakalama için sonuç kodları.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri asla ayarlamayın.
ACKNOWLEDGED Yakalama isteği gönderildi ve entegrasyon uzmanı, yakalamanın başarılı mı yoksa başarısız mı olduğunu belirlemek için ek adımlar gerçekleştirecek. Entegratör, yakalamanın sonucunu öğrendikten sonra captureResultNotification API'yi çağırarak sonucu Google'a bildirir.
ACCOUNT_CLOSED

Kullanıcının entegrasyon uzmanındaki hesabı kapatıldı.

Bu değerin döndürülmesi, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı, ilişkilendirme akışından tekrar geçerek 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 değerin döndürülmesi, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı, ilişkilendirme akışından tekrar geçerek yeni bir araç eklemeye zorlanır.
ACCOUNT_ON_HOLD Hesap askıya alındı.
ACCOUNT_CLOSED_FRAUD

Kullanıcının entegrasyon uzmanındaki hesabı sahtekarlık nedeniyle kapatıldı.

Bu değerin döndürülmesi, kullanıcının aracının Google ile kapatılmasına neden olur. Kullanıcı, ilişkilendirme akışından tekrar geçerek yeni bir araç eklemeye zorlanır.