Method: remittanceStatementNotification

通知集成商有新的汇款对账单。

每当有人提交新的对账单，表明 Google 将向集成商或集成商欠 Google 的款项时，系统都会发送对账单通知。

如果集成商返回成功结果，则认为该声明已被接受并将付款。

requestId 也是语句 ID（在其他地方使用）。标头中的 requestId 和 paymentIntegratorAccountId 的组合是幂等键，可唯一标识此语句。

如果端点在处理请求时遇到错误，此端点的响应正文应为 ErrorResponse 类型。

示例请求如下所示：


{
  "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"
    }
  }
}

示例响应如下所示：


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

HTTP 请求

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

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "remittanceStatementSummary": {
    object (RemittanceStatementSummary)
  }
}
字段
requestHeader

object (RequestHeader)

必需：所有请求的通用标头。
paymentIntegratorAccountId

string

必需：这是付款集成商账号标识符，用于标识此对账单所遵循的合同限制。
remittanceStatementSummary

object (RemittanceStatementSummary)

必需：此汇款对账单的摘要。

响应正文

汇款对账单通知方法的响应对象。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "paymentIntegratorStatementId": string,
  "result": enum (StatementNotificationResultCode)
}
字段
responseHeader

object (ResponseHeader)

必需：所有响应的通用标头。
paymentIntegratorStatementId

string

必需：集成商知道此语句的标识符。由集成商生成。
result

enum (StatementNotificationResultCode)

必需：此对账单通知的结果。

RemittanceStatementSummary

关于汇款对账单的摘要对象。

JSON 表示法 
{
  "statementDate": string,
  "billingPeriod": {
    object (BillingPeriod)
  },
  "dateDue": string,
  "currencyCode": string,
  "totalDueByIntegrator": string,
  "remittanceInstructions": {
    object (RemittanceInstructions)
  }
}
字段
statementDate

string (int64 format)

必需：创建此对账单的日期（在美国/洛杉矶）。
billingPeriod

object (BillingPeriod)

必需：此对账单涵盖的结算周期。
dateDue

string (int64 format)

可选：汇款截止日期。这以从公元纪年开始计算的毫秒数表示。它是日期（因此始终从结算时区当天的第一毫秒开始）。

只要 totalDueByIntegrator 大于 0，系统就会设置此值。
currencyCode

string

必需：ISO 4217 货币代码（由 3 个字母组成）。
totalDueByIntegrator

string (Int64Value format)

必需：此值以微单位（货币 currencyCode）为单位。此值始终为正数。
remittanceInstructions

object (RemittanceInstructions)

必需：有关如何汇款的详细信息

BillingPeriod

此对账单的结算周期。

JSON 表示法 
{
  "startDate": string,
  "endDate": string
}
字段
startDate

string (int64 format)

必需：结算周期的开始日期。这以从公元纪年开始计算的毫秒数表示。它是日期（因此始终从结算时区当天的第一毫秒开始）。

这是结算周期当天的第一毫秒，即 00:00:00.000
endDate

string (int64 format)

必需：结算周期的结束日期。这以从公元纪年开始计算的毫秒数表示。

这是相应结算周期的最后一天的最后 1 毫秒，即 23:59:59.999

RemittanceInstructions

包含有关如何支付此汇款通知的信息的结构。

JSON 表示法 
{
  "memoLineId": string
}
字段
memoLineId

string

必需：必须显示在付款通知单行中以便识别汇款身份的标识符。

StatementNotificationResultCode

对账单通知的结果代码。

枚举
UNKNOWN_RESULT 切勿设置此默认值！
ACCEPTED 集成商已接受此声明。