Method: remittanceStatementDetails

Havale ekstresi ile ilgili işlem ayrıntıları bilgilerini döndürür.

Bu, sayfalara ayrılmış bir API'dir. Sayfa başına işlem etkinliği sayısı numberOfEvents ile belirtilebilir. Belirtilmemişse sayfa başına en fazla 1.000 etkinlik döndürülür. Bu API'ye yapılan her istek, ifadedeki bir sonraki işlem etkinliğini işaret eden bir nextEventOffset değerinin yanı sıra ifadedeki toplam işlem sayısını belirten totalEvents döndürür. Şu anda alınmış olan sayfa, ifadedeki son işlemleri içeriyorsa yanıtta nextEventOffset bulunmaz.

statementId değeri, remittanceStatementNotificationRequest ile elde edilen requestId değeridir

Uç nokta, isteği işlerken bir hatayla karşılaşırsa bu uç noktadan gelen yanıt ErrorResponse türünde olur.

Bu yöntem bir HTTP 200 döndürmezse bu sorguya verilen yanıtlar boş olabilir. Net bir açıklamaya sahip ErrorResponse, bir saldırganın diğer entegratörlerin ödeme entegratörü hesap tanımlayıcısını anlamasına yardımcı olmak için kullanılabileceği durumlarda yanıt gövdesi boştur. İmzalama anahtarının eşleşmediği, ödeme entegratörü tanımlayıcısının bulunamadığı veya şifreleme anahtarının bilinmediği bu durumlarda bu yöntem, gövdesi boş olan bir HTTP 404 döndürür. İstek imzası doğrulanabildiyse yanıt gövdesinde hatayla ilgili ek bilgiler döndürülür.

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


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "statement_detail_request_139932019",
    "requestTimestamp": "1502551332087"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "statementId": "0123434-statement-abc",
  "numberOfEvents": 4
}

Örnek bir yanıt şöyle görünür:


{
  "responseHeader": {
    "responseTimestamp": "1481900013178"
  },
  "eventOffset": 0,
  "nextEventOffset": 4,
  "totalEvents": 15,
  "remittanceStatementSummary": {
    "statementDate": "1502521200000",
    "billingPeriod": {
      "startDate": "1502434800000",
      "endDate": "1502434800000"
    },
    "dateDue": "1502348400000",
    "currencyCode": "INR",
    "totalDueByIntegrator": "1076000000",
    "remittanceInstructions": {
      "memoLineId": "stmt-1AB-pp0-invisi"
    }
  },
  "captureEvents": [
    {
      "eventRequestId": "bWVyY2hhbnQgdHJhbnNhY3Rpb24gaWQ",
      "paymentIntegratorEventId": "ioj32SOIjf23oijSDfoij",
      "eventCharge": "700000000",
      "eventFee": "-28000000"
    },
    {
      "eventRequestId": "Ggghvh78200PQ3Yrpb",
      "paymentIntegratorEventId": "iasdf23dSdfijSDfoij",
      "eventCharge": "800000000",
      "eventFee": "-32000000"
    }
  ],
  "refundEvents": [
    {
      "eventRequestId": "liUrreQY233839dfFFb24gaQM",
      "paymentIntegratorEventId": "asd3SDf3f3oijSDfoij",
      "eventCharge": "-200000000",
      "eventFee": "8000000"
    },
    {
      "eventRequestId": "IIghhhUrreQY233839II9qM==",
      "paymentIntegratorEventId": "DFjidoso12FSDFSDE",
      "eventCharge": "-150000000",
      "eventFee": "6000000"
    }
  ]
}

HTTP isteği

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

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "statementId": string,
  "eventOffset": integer,
  "numberOfEvents": integer
}
Alanlar
requestHeader

object (RequestHeader)

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

string

ZORUNLU: Bu ifadeyle ilgili sözleşmeden doğan kısıtlamaları tanımlayan ödeme entegratörü hesap kimliğidir.
statementId

string

ZORUNLU: Ekstre bildiriminin istek kimliği.
eventOffset

integer

İSTEĞE BAĞLI: Bu ofsetten başlayan etkinlikleri döndürür. İlk istek iade edildiyse veya belirtilmeden bırakıldıysa bu değer nextEventOffset olarak ayarlanmalıdır. eventOffset sıfırsa etkinlikler ilk etkinlikten başlayarak döndürülür. Bu iki sayıysa etkinlikler üçüncü etkinlikten başlayarak döndürülür. Belirtilmezse eventOffset değeri sıfır olarak kabul edilir.

numberOfEvents

integer

İSTEĞE BAĞLI: Sayfa başına gösterilecek etkinlik sayısı. Belirtilmemişse veya 1.000'den büyükse bu sayı 1.000 olur.

Yanıt gövdesi

Havale ekstresi ayrıntı 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)
  },
  "remittanceStatementSummary": {
    object (RemittanceStatementSummary)
  },
  "eventOffset": integer,
  "nextEventOffset": integer,
  "totalEvents": integer,
  "totalWithholdingTaxes": string,
  "captureEvents": [
    {
      object (Event)
    }
  ],
  "refundEvents": [
    {
      object (Event)
    }
  ],
  "reverseRefundEvents": [
    {
      object (Event)
    }
  ],
  "chargebackEvents": [
    {
      object (Event)
    }
  ],
  "reverseChargebackEvents": [
    {
      object (Event)
    }
  ],
  "adjustmentEvents": [
    {
      object (Event)
    }
  ]
}
Alanlar
responseHeader

object (ResponseHeader)

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

object (RemittanceStatementSummary)

ZORUNLU: Bu havale özeti.
eventOffset

integer

ZORUNLU: Bu yanıtın etkinlik ofseti.
nextEventOffset

integer

İSTEĞE BAĞLI: Döndürülecek bir sonraki etkinliğin göreli konumu. Belirtilmemişse bu ifade için alınacak başka etkinlik yoktur.
totalEvents

integer

ZORUNLU: Bu ifadedeki toplam etkinlik sayısı.
totalWithholdingTaxes

string (Int64Value format)

ZORUNLU: Bu hesap özeti için stopaj uygulanan tüm vergilerin toplamı.

Bu değer mikro cinsindendir.
captureEvents[]

object (Event)

ZORUNLU: Yakalama etkinlikleri grubu.
refundEvents[]

object (Event)

ZORUNLU: Geri ödeme etkinlikleri grubu.
reverseRefundEvents[]

object (Event)

İSTEĞE BAĞLI: Geri ödeme etkinlikleri grubu.
chargebackEvents[]

object (Event)

İSTEĞE BAĞLI: Ters ibraz etkinlikleri grubu.
reverseChargebackEvents[]

object (Event)

İSTEĞE BAĞLI: Ters ters ibraz etkinlikleri grubu.
adjustmentEvents[]

object (Event)

İSTEĞE BAĞLI: Düzenleme etkinlikleri grubu. Faturalandırma tutarsızlıklarını düzeltmek için Google'ın şahsi karar verme yetkisiyle düzenleme etkinlikleri eklenebilir. Örneğin, önceki bir dizi işlem için ücretler eksik hesaplanmışsa entegratörü bütünleştirmek için bir düzenleme kullanılabilir.

RemittanceStatementSummary

Havale özetiyle ilgili özet nesnesi.

JSON gösterimi 
{
  "statementDate": string,
  "billingPeriod": {
    object (BillingPeriod)
  },
  "dateDue": string,
  "currencyCode": string,
  "totalDueByIntegrator": string,
  "remittanceInstructions": {
    object (RemittanceInstructions)
  }
}
Alanlar
statementDate

string (int64 format)

ZORUNLU: Bu bildirimin oluşturulduğu tarih (Amerika/Los Angeles'ta).
billingPeriod

object (BillingPeriod)

ZORUNLU: Bu ekstrenin kapsadığı fatura dönemi.
dateDue

string (int64 format)

İSTEĞE BAĞLI: Havalenin ödenmesi gereken tarih. Dönemden itibaren milisaniye olarak temsil edilir. Bu bir tarihtir (ve bu nedenle, faturalandırma saat dilimine göre her zaman günün ilk milisaniyesinde başlar).

Bu değer, totalDueByIntegrator 0'dan büyük olduğu sürece ayarlanır.
currencyCode

string

ZORUNLU: ISO 4217 3 harfli para birimi kodu.
totalDueByIntegrator

string (Int64Value format)

ZORUNLU: Bu değer, currencyCode para birimi cinsinden mikro cinsindendir. Bu değer her zaman pozitiftir.
remittanceInstructions

object (RemittanceInstructions)

ZORUNLU: Ödemenin nasıl yapılacağıyla ilgili ayrıntılar

BillingPeriod

Bu ekstrenin fatura dönemi.

JSON gösterimi 
{
  "startDate": string,
  "endDate": string
}
Alanlar
startDate

string (int64 format)

ZORUNLU: Fatura döneminin başlangıç tarihi. Dönemden itibaren milisaniye olarak temsil edilir. Bu bir tarihtir (ve bu nedenle, faturalandırma saat dilimine göre her zaman günün ilk milisaniyesinde başlar).

Bu, fatura dönemindeki günün ilk milisaniyesidir, 00:00:00.000
endDate

string (int64 format)

ZORUNLU: Fatura döneminin bitiş tarihi. Dönemden itibaren milisaniye olarak temsil edilir.

Bu, fatura döneminin son gününün son milisaniyesidir, 23:59:59.999

RemittanceInstructions

Bu havale bildiriminin nasıl ödeneceğiyle ilgili bilgileri tutan yapı.

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

string

ZORUNLU: Havale kimliği için ödeme notu satırına eklenmesi zorunlu olan kimlik.

Etkinlik

Havale bildiriminde yer alan tek bir etkinliği temsil eden yapı.

JSON gösterimi 
{
  "eventRequestId": string,
  "paymentIntegratorEventId": string,
  "eventCharge": string,
  "eventFee": string,
  "presentmentChargeAmount": string,
  "presentmentCurrencyCode": string,
  "exchangeRate": string,
  "nanoExchangeRate": string
}
Alanlar
eventRequestId

string

ZORUNLU: Yakalama veya geri ödeme etkinlikleri için bu, Google'ın istekle birlikte gönderdiği requestId olacaktır. Ters geri ödeme, ters ibraz ve ters ibraz etkinlikleri için Ödeme Entegratörü'nün söz konusu etkinliğin bildirimiyle birlikte gönderdiği requestId olur. Düzenlemeler için bu değer, Google tarafından düzenleme etkinliğine atanan benzersiz bir kimlik olacaktır.
paymentIntegratorEventId

string

ZORUNLU: Ödeme entegratörünün bu etkinlik için döndürdüğü kimlik. Bir yakalama için bu, capture çağrısına verilen yanıttaki paymentIntegratorTransactionId; geri ödeme içinse refund çağrısına verilen yanıtın paymentIntegratorRefundId değeridir.

Bu alan değişken uzunluktadır. Bu nedenle, entegratör olarak bu etkinlik için sağladığınız kimlik buraya yansıtılır. Entegratör ilgili etkinlik için bir değer sağlamadıysa bu alan, eventRequestId alanı ile aynı değeri içerir.

Ters geri ödeme, ters ibraz ve ters ibraz etkinlikleri için, Ödeme Entegratörü'nün etkinliğin bildirimiyle birlikte gönderdiği requestId olur.

Bu alanın uzunluğu ve biçimi, her kimliğin kaynak alanına bağlıdır. Uzunluk ve karakter kümesi gereksinimleri hakkında ayrıntılı bilgi için kaynak alanların her biriyle ilgili dokümanlara bakın. Özellikle, bu alanın bazen Google tarafından oluşturulmuş ve entegratör tarafından oluşturulan kimliklerden farklı maksimum uzunluk şartlarına sahip kimlikler içerebileceğini unutmayın.
eventCharge

string (Int64Value format)

ZORUNLU: İfade tarafından tanımlanan para birimi kodu. Bu değer negatifse Google'dan ödeme entegratörüne taşınan parasal değeri temsil eder. Bu pozitifse ödeme entegratörden gelen ve Google'a ödenecek paradır.

Örneğin, yakalama işlemleri her zaman pozitif, geri ödeme işlemleri ise her zaman negatif olur. Ters geri ödeme ve ters ibraz etkinlikleri her zaman olumlu olur. Ters ibraz etkinlikleri her zaman negatif olur.

Bu değer mikro cinsindendir.
eventFee

string (Int64Value format)

ZORUNLU: İfade tarafından tanımlanan para birimi kodu. Bu değer negatifse Google'dan ödeme entegratörüne taşınan parasal değeri temsil eder. Bu pozitifse ödeme entegratörden gelen ve Google'a ödenecek paradır.

Örneğin, bir sözleşmede Google'ın transactionCharge tutarının% 1'ini ödeme entegratöre ödeyeceği belirtiliyorsa ve bu işlem geri ödendiğinde% 1'lik kısım geri alınırsa yakalama ücreti negatif olur ve geri ödeme yapıldıktan sonra geri ödeme ücreti pozitif olur.

Bu değer mikro cinsindendir.
presentmentChargeAmount

string (Int64Value format)

İSTEĞE BAĞLI: Döviz kurundan önceki sunum (işlem) para birimindeki işlem tutarı. Bu alanda, eventCharge alanı ile aynı işaret kuralı uygulanır.

Bu değer mikro cinsindendir.

presentmentCurrencyCode

string

İSTEĞE BAĞLI: sunumun (işlem) para birimini belirten 3 harfli ISO 4217 para birimi kodu.

exchangeRate

string (Int64Value format)

İSTEĞE BAĞLI: Teklif tutarının ödeme (fatura) tutarına dönüştürülmesinde kullanılan döviz kuru.

Bu değer, mikro temel puandır (1 baz puan = 0,0001 = %0,01). Yani, döviz kurunu elde etmek için bu alanı 10^10'a bölün.
nanoExchangeRate

string (Int64Value format)

İSTEĞE BAĞLI: Sunu tutarının ödeme (fatura) tutarına dönüştürülmesinde kullanılan ve nano bazlı puan cinsinden ifade edilen döviz kuru.

Bu değer, nano temel puan cinsindendir (1 temel puan = 0,0001 = %0,01). Yani, döviz kurunu elde etmek için bu alanı 10^13'e bölün.

Hem bu alan hem de exchangeRate doldurulacaktır. Bunlar, farklı hassasiyetle ifade edilen eşdeğer döviz kurlarıdır. Gelecekteki sürümlerde exchangeRate, nanoExchangeRate yerini alacak şekilde kaldırılacaktır.