- HTTP isteği
- İstek gövdesi
- Yanıt metni
- RemittanceStatementÖzeti
- Fatura Dönemi
- Havale Talimatları
- StatementNotificationSonuçKodu
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
türünde olmalıdır.ErrorResponse
Ö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 ( |
Alanlar | |
---|---|
requestHeader |
ZORUNLU: Tüm istekler için ortak üstbilgi. |
paymentIntegratorAccountId |
ZORUNLU: Bu ekstreyle ilgili sözleşme kısıtlamalarını tanımlayan ödeme entegratörü hesap tanımlayıcısıdır. |
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 ( |
Alanlar | |
---|---|
responseHeader |
ZORUNLU: Tüm yanıtlar için ortak başlık. |
paymentIntegratorStatementId |
GEREKLİ: Entegre eden tanımlayıcı bu ifadeyi bilir. Bu, entegratör tarafından oluşturulmuştur. |
result |
GEREKLİ: Bu ifade bildiriminin sonucu. |
Havale Durum Özeti
Havale özeti hakkında özet nesne
JSON gösterimi |
---|
{ "statementDate": string, "billingPeriod": { object ( |
Alanlar | |
---|---|
statementDate |
GEREKLİ: Bu ifadenin oluşturulduğu tarih (Amerika/Los Angeles'ta). |
billingPeriod |
ZORUNLU: Bu hesap özetinin kapsadığı fatura dönemi. |
dateDue |
İ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, |
currencyCode |
ZORUNLU: ISO 4217 3 harfli para birimi kodu. |
totalDueByIntegrator |
GEREKLİ: Bu değer, |
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 |
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 |
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 |
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. |