Method: remittanceStatementNotification

Yeni bir havale bildiriminin entegratörünü bilgilendirir.

Ekstre bildirimleri, Google'a entegratör veya Google'a borçlu olduğu parayı temsil eden yeni bir ifade her gönderildiğinde görüntülenir.

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

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

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

Örnek bir 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:


{
  "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 veriler içerir:

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

object (RequestHeader)

ZORUNLU: Tüm istekler için ortak üstbilgi.
paymentIntegratorAccountId

string

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

object (RemittanceStatementSummary)

GEREKLİ: Bu havale ekstresinin özeti.

Yanıt gövdesi

Havale özeti 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

GEREKLİ: Entegre eden tanımlayıcı bu ifadeyi bilir. Bu, entegratör tarafından oluşturulmuştur.
result

enum (StatementNotificationResultCode)

GEREKLİ: Bu ifade bildiriminin sonucu.

Havale Durum Özeti

Havale özeti hakkında özet nesne

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

string (int64 format)

GEREKLİ: Bu ifadenin oluşturulduğu tarih (Amerika/Los Angeles'ta).
billingPeriod

object (BillingPeriod)

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

string (int64 format)

İSTEĞE BAĞLI: Havalenin yapılması gereken tarih. Bu, epoch'tan itibaren milisaniye olarak gösterilir. Bir tarihtir (ve bu nedenle, faturalandırma saat diliminde 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)

GEREKLİ: Bu değer, currencyCode para biriminde mikro cinsindendir. Bu değer her zaman pozitiftir.
remittanceInstructions

object (RemittanceInstructions)

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

Fatura Dönemi

Bu ekstrenin fatura dönemi.

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

string (int64 format)

GEREKLİ: Fatura döneminin başlangıç tarihi. Bu, epoch'tan itibaren milisaniye olarak gösterilir. Bir tarihtir (ve bu nedenle, faturalandırma saat diliminde her zaman günün ilk milisaniyesinde başlar).

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

string (int64 format)

ZORUNLU: Fatura döneminin bitiş tarihi. Bu, epoch'tan itibaren milisaniye olarak gösterilir.

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

Havale Talimatları

Bu havale bildiriminin nasıl ödeneceğine dair bilgileri içeren yapı.

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

string

ZORUNLU: Havale kimlik ödemesinin not satırına eklenmesi zorunlu olan tanımlayıcı.

StatementNotificationSonuç Kodu

Ekstre bildirimi için sonuç kodları.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri hiçbir zaman ayarlama!
ACCEPTED Entegratör bu ifadeyi kabul etti.