Method: remittanceStatementNotification

Yeni bir havale beyanı hakkında entegrasyon uzmanına bilgi verir.

Google'ın entegrasyon uzmanına ödeyeceği parayı veya entegrasyon uzmanının Google'a borçlu olduğu tutarı temsil eden yeni bir ifadenin paylaşıldığı her seferde ekstre bildirimleri gönderilir.

Entegratör başarılı olursa beyanın kabul edildiği ve ödeneceği varsayılır.

requestId, aynı zamanda ifade kimliğidir (başka bir yerde kullanılır). Başlık içindeki requestId ve paymentIntegratorAccountId kombinasyonu idempotent anahtarıdır ve bu ifadeyi benzersiz bir şekilde tanımlar.

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": "0123434-statement-abc",
    "requestTimestamp": "1502632800000"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "remittanceStatementSummary": {
    "statementDate": "1502607600000",
    "billingPeriod": {
      "startDate": "1502434800000",
      "endDate": "1502521199000"
    },
    "dateDue": "1503212400000",
    "currencyCode": "INR",
    "totalDueByIntegrator": "1076000000",
    "remittanceInstructions": {
      "memoLineId": "stmt-1AB-pp0-invisi"
    }
  }
}

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


{
  "responseHeader": {
    "responseTimestamp": "1502632802000"
  },
  "paymentIntegratorStatementId": "334a",
  "result": "ACCEPTED"
}

HTTP isteği

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

İstek içeriği

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

JSON gösterimi 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "remittanceStatementSummary": {
    object (RemittanceStatementSummary)
  }
}
Alanlar
requestHeader

object (RequestHeader)

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

string

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

object (RemittanceStatementSummary)

ZORUNLU: Bu havale ekstresinin özeti.

Yanıt gövdesi

Havale beyanı bildirim yöntemi için 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)
  },
  "paymentIntegratorStatementId": string,
  "result": enum (StatementNotificationResultCode)
}
Alanlar
responseHeader

object (ResponseHeader)

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

string

ZORUNLU: Entegratörün bu ifadeyi olarak bildiği tanımlayıcı. Bu, entegratör tarafından oluşturulmuştur.
result

enum (StatementNotificationResultCode)

ZORUNLU: Bu bildirimin sonucu.

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 yer aldığı fatura dönemidir.
dateDue

string (int64 format)

İSTEĞE BAĞLI: Havalenin yapılması gereken tarih. Bu değer, epoch'tan itibaren milisaniye cinsinden temsil edilir. Bu bir tarihtir (ve bu nedenle faturalandırma saat dilimine göre her zaman günün ilk milisaniyesinde başlar).

Bu, totalDueByIntegrator değeri 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 mikro cinsinden currencyCode para birimi cinsindendir. Bu değer her zaman pozitifdir.
remittanceInstructions

object (RemittanceInstructions)

ZORUNLU: Ödemenin nasıl yapılacağına ilişkin 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. Bu değer, epoch'tan itibaren milisaniye cinsinden 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, fatura dönemi gününün ilk milisaniyesi olan 00:00:00.000'dır.
endDate

string (int64 format)

ZORUNLU: Fatura döneminin bitiş tarihi. Bu değer, epoch'tan itibaren milisaniye cinsinden temsil edilir.

Bu değer, fatura döneminin son gününün son milisaniyesi olan 23:59:59.999'dur.

RemittanceInstructions

Bu havale bildiriminin nasıl ödeneceğine dair bilgilerin bulunduğu yapı.

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

string

ZORUNLU: Havale kimliği ödemesi için not satırına eklenmesi zorunlu olan tanımlayıcı.

StatementNotificationResultCode

Ekstre bildirimi için sonuç kodları.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri asla ayarlamayın.
ACCEPTED Entegratör bu beyanı kabul etti.