송금 명세서의 거래 세부정보를 반환합니다.
페이지로 나눈 API입니다. 페이지당 거래 이벤트 수는 numberOfEvents
로 지정할 수 있습니다. 지정하지 않으면 페이지당 최대 1, 000개의 이벤트가 반환됩니다. 이 API에 대한 각 요청은 문에서 다음 트랜잭션 이벤트를 가리키는 nextEventOffset
와 함께 문에서 총 트랜잭션 수를 지정하는 totalEvents
를 반환합니다. 현재 검색된 페이지에 문의 마지막 트랜잭션이 포함되어 있으면 응답에 nextEventOffset
가 표시되지 않습니다.
statementId
값은 remittanceStatementNotificationRequest
의 requestId
입니다.
요청을 처리하는 중에 엔드포인트에서 오류가 발생하면 이 엔드포인트의 응답은
유형입니다.ErrorResponse
이 메서드가 HTTP 200을 반환하지 않으면 이 쿼리에 대한 응답이 비어 있을 수 있습니다. 공격자가 다른 통합자의 결제 통합업체 계정 식별자를 이해하는 데 도움이 되도록 명확한 설명이 포함된
를 사용할 수 있는 상황에서는 응답 본문이 비어 있습니다. 서명 키가 일치하지 않거나 결제 통합업체 식별자를 찾을 수 없거나 암호화 키를 알 수 없는 경우 이 메서드는 본문이 비어 있는 HTTP 404를 반환합니다. 요청 서명을 인증할 수 있으면 오류와 관련된 추가 정보가 응답 본문에 반환됩니다.ErrorResponse
요청의 예는 다음과 같습니다.
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 0,
"revision": 0
},
"requestId": "statement_detail_request_139932019",
"requestTimestamp": "1502551332087"
},
"paymentIntegratorAccountId": "InvisiCashUSA_USD",
"statementId": "0123434-statement-abc",
"numberOfEvents": 4
}
응답 예시는 다음과 같습니다.
{
"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 요청
POST https://vgw.googleapis.com/secure-serving/gsp/v1/remittanceStatementDetails/:PIAID
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"requestHeader": {
object ( |
필드 | |
---|---|
requestHeader |
필수: 모든 요청의 공통 헤더입니다. |
paymentIntegratorAccountId |
필수: 이 명세서와의 계약상 제약을 식별하는 결제 통합업체 계정 식별자입니다. |
statementId |
필수: 명세서 알림의 요청 ID입니다. |
eventOffset |
선택사항: 이 오프셋부터 시작하는 이벤트를 반환합니다. 반환된 경우 |
numberOfEvents |
선택사항: 페이지당 표시할 이벤트 수입니다. 지정되지 않거나 1,000보다 크면 1,000이 됩니다. |
응답 본문
송금 명세서 세부정보 메서드의 응답 객체입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "responseHeader": { object ( |
필드 | |
---|---|
responseHeader |
필수: 모든 응답의 공통 헤더입니다. |
remittanceStatementSummary |
필수: 송금 명세서 요약 |
eventOffset |
필수: 이 응답의 이벤트 오프셋입니다. |
nextEventOffset |
선택사항: 반환할 다음 이벤트의 오프셋입니다. 지정하지 않으면 이 문에 대해 검색할 이벤트가 더 이상 없습니다. |
totalEvents |
필수: 이 문의 총 이벤트 수입니다. |
totalWithholdingTaxes |
필수: 명세서에서 원천징수된 모든 세금의 합계입니다. 이 값은 마이크로 단위입니다. |
captureEvents[] |
필수: 캡처 이벤트의 집합입니다. |
refundEvents[] |
필수: 환불 이벤트의 집합입니다. |
reverseRefundEvents[] |
선택사항: 역방향 환불 이벤트의 집합입니다. |
chargebackEvents[] |
선택사항: 지불 거절 이벤트 집합입니다. |
reverseChargebackEvents[] |
선택사항: 지불 거절 철회 이벤트 집합입니다. |
adjustmentEvents[] |
선택사항: 조정 이벤트의 집합입니다. Google의 재량에 따라 청구 불일치를 조정하기 위해 조정 이벤트를 추가할 수 있습니다. 예를 들어 이전 거래 집합에 대해 수수료가 과소 계산되는 경우 통합업체를 조정하기 위해 조정을 사용할 수 있습니다. |
RemittanceStatementSummary 클래스의 생성자
송금 명세서의 요약 객체입니다.
JSON 표현 |
---|
{ "statementDate": string, "billingPeriod": { object ( |
필드 | |
---|---|
statementDate |
필수: 이 명세서가 작성된 날짜입니다 (미국/로스앤젤레스). |
billingPeriod |
필수: 이 명세서에 포함된 결제 기간입니다. |
dateDue |
선택사항: 송금 기한입니다. 에포크로부터 밀리초로 표시됩니다. 날짜입니다 (따라서 항상 결제 시간대에서 하루의 처음 밀리초로 시작함).
|
currencyCode |
필수: 3자리 ISO 4217 통화 코드입니다. |
totalDueByIntegrator |
필수: 이 값은 마이크로 통화이며 |
remittanceInstructions |
필수: 결제 방법 세부정보 |
결제 기간
이 명세서의 결제 기간입니다.
JSON 표현 |
---|
{ "startDate": string, "endDate": string } |
필드 | |
---|---|
startDate |
필수: 결제 기간의 시작일입니다. 에포크로부터 밀리초로 표시됩니다. 날짜입니다 (따라서 항상 결제 시간대에서 하루의 처음 밀리초로 시작함). 결제 기간의 첫 밀리초인 00:00:00.000입니다. |
endDate |
필수: 결제 기간의 종료일입니다. 에포크로부터 밀리초로 표시됩니다. 결제 기간의 마지막 날인 23:59:59.999의 마지막 밀리초입니다. |
송금 안내
송금 알림 결제 방법에 대한 정보가 포함된 구조
JSON 표현 |
---|
{ "memoLineId": string } |
필드 | |
---|---|
memoLineId |
필수: 송금 식별을 위해 결제 금액을 메모하기 위해 반드시 입력해야 하는 식별자입니다. |
이벤트
송금 명세서에 포함된 단일 이벤트를 나타내는 구조입니다.
JSON 표현 |
---|
{ "eventRequestId": string, "paymentIntegratorEventId": string, "eventCharge": string, "eventFee": string, "presentmentChargeAmount": string, "presentmentCurrencyCode": string, "exchangeRate": string, "nanoExchangeRate": string } |
필드 | |
---|---|
eventRequestId |
필수: 캡처 또는 환불 이벤트의 경우 Google에서 요청과 함께 전송하는 |
paymentIntegratorEventId |
필수: 이 이벤트에 대해 반환된 결제 통합업체의 ID입니다. 캡처의 경우 이 이벤트의 가변 ID입니다. 이 이벤트에 제공한 ID가 여기에 반영됩니다. 통합자가 해당 이벤트의 값을 제공하지 않은 경우 이 필드에는 역방향 환불, 지불 거절 및 지불 거절 철회 이벤트의 경우 결제 통합업체가 이벤트 알림과 함께 전송한 이 필드의 길이와 형식은 각 ID의 소스 필드에 따라 다릅니다. 길이 및 문자 집합 요구사항에 대한 자세한 내용은 각 소스 필드의 문서를 참조하세요. 특히 이 필드에는 Google에서 생성한 ID가 포함될 수 있으며 통합자 생성 ID와 최대 길이 요구사항이 다를 수 있습니다. |
eventCharge |
필수: 문에서 정의된 통화 코드입니다. 이 값이 음수이면 Google에서 결제 통합업체로 이동하는 금전적 가치를 나타냅니다. 양수인 경우 Google로 인해 결제 통합업체에서 금액을 인출합니다. 예를 들어 캡처 거래는 항상 양수이고 환불 거래는 항상 음수입니다. 환불 취소 및 지불 거절 철회 이벤트는 항상 양수입니다. 지불 거절 이벤트는 항상 음수입니다. 이 값은 마이크로 단위입니다. |
eventFee |
필수: 문에서 정의된 통화 코드입니다. 이 값이 음수이면 Google에서 결제 통합업체로 이동하는 금전적 가치를 나타냅니다. 양수인 경우 Google로 인해 결제 통합업체에서 금액을 인출합니다. 예를 들어 Google이 결제 통합업체에 이 값은 마이크로 단위입니다. |
presentmentChargeAmount |
선택사항: 외화 거래 전에 표시되는 현재 통화의 거래 금액 (거래)입니다. 이 필드는 이 값은 마이크로 단위입니다. |
presentmentCurrencyCode |
선택사항: ISO 4217 3자리 통화 코드로 현재 (거래) 통화를 나타냅니다. |
exchangeRate |
선택사항: 현재 금액을 정산 (인보이스) 금액으로 변환하는 데 사용되는 환율입니다. 이 값은 마이크로 기준점 (1기준점 = .0001 = .01%)으로 표시됩니다. 환율을 확인하려면 이 필드를 10^10으로 나눕니다. |
nanoExchangeRate |
선택사항: 현재 금액을 정산 (인보이스) 금액으로 변환하는 데 사용되는 환율로, 나노 기준점으로 표시됩니다. 이 값은 nano 기준점 (1 기준점 = .0001 = .01%)으로 표시됩니다. 환율을 확인하려면 이 필드를 10^13으로 나눕니다. 이 필드와 ExchangeRate 모두 채워집니다. 정밀도는 각기 다른 환율로 표현됩니다. 향후 버전에서는 exchangeRate 대신 nanoExchangeRate를 사용할 예정입니다. |