본문 바로가기
정산조회 API

글로벌셀러 예치금 송금 내역 조회 API

Description
[POST] https://sa2.esmplus.com/account/v1/settle/GetGlobalSellerTransfer
글로벌셀러 예치금 송금 내역을 조회할 수 있습니다.
현 ESM PLUS 내 글로벌셀러 예치금관리 송금완료 내역에서 확인되는 데이터를 조회 가능 합니다.

Request Description

항목 항목명 필수여부 Type Description
SiteType 사이트구분 Y string 조회하고자 하는 사이트 구분
A : 옥션
G : G마켓
TransferNumber 송금번호   long 조회하고자 하는 송금번호 입력
일자로 조회시 제외 또는 null 입력 후 조회
SrchStartDate 조회기준 시작일 Y Date YYYY-MM-DD 형태
SrchEndDate 조회기준 종료일 Y Date YYYY-MM-DD 형태
PageNo 페이지번호 Y int  
PageRowCnt 1Page Max Y int  
JSON
{
  "SiteType": "string",
  "TransferNumber": null,
  "SrchStartDate": "2026-01-15",
  "SrchEndDate": "2026-01-16",
  "PageNo": 0,
  "PageRowCnt": 0
}

 

Response Description

항목 항목명 Type Description
ResultCode 결과 int 성공 : Success
실패 : Error Massage 참고
Message 메시지 stirng  
SiteType 사이트구분 string A : 옥션
G : G마켓
Details 에러상세 string 에러 발생 시 상세 사유
TotalCount 총건수 int 조회된 총 건수
TotalTransferAmountForeign > Currency 통화 string 송금된 통화
TotalTransferAmountForeign > CurrencyTransferAmountForeign
통화 기준 외화 금액 합계 Number 조회 내역 내 해당 통화 기준
TransferAmountForeign 합계 금액
SellerId 판매자ID string  
PageSize 페이지사이즈 int  
PageNo 페이지번호 int  
Data > TransferNumber 송금번호 int  
Data > TransferDate 송금일 Date  
Data > ExchangeRate 환율 int  
Data > Currency 통화 string  
Data > TransferAmountForeign 송금액(외화) int  
Data >  TransferAmountKr 송금액(원화) int  

 

JSON_Success

{
  "TotalCount": 0,
  "TotalTransferAmountForeign": [
    {
      "Currency": "string",
      "CurrencyTransferAmountForeign": 0
    }
  ],
  "SellerId": "string",
  "PageSize": 0,
  "PageNo": 0,
  "SiteType": "string",
  "ResultCode": 0,
  "Message": "string",
  "Details": {},
  "Data": [
    {
      "TransferNumber": 0,
      "TransferDate": "2026-01-15T04:40:16.754Z",
      "ExchangeRate": 0,
      "Currency": "string",
      "TransferAmountForeign": 0,
      "TransferAmountKr": 0
    }
  ]
}

Sample Code_Success

지마켓
{
    "TotalCount": 1,
    "TotalTransferAmountForeign": [
        {
            "Currency": "USD",
            "CurrencyTransferAmountForeign": 3.7200
        }
    ],
    "SellerId": "testtest",
    "PageSize": 1000,
    "PageNo": 1,
    "SiteType": "G",
    "ResultCode": 0,
    "Message": "",
    "Data": [
        {
            "TransferNumber": 100000,
            "TransferDate": "2026-01-02T14:13:12.127",
            "ExchangeRate": 1482.9000,
            "Currency": "USD",
            "TransferAmountForeign": 3.7200,
            "TransferAmountKr": 5511.0000
        }
    ]
}

Sample Code_Fail

{
    "ResultCode": 401,
    "Message": "The request failed because it contained an invalid header.",
    "Details": "'ExternalFinanceApi.Common.Exceptions.CustomBizException' 형식의 예외가 Throw되었습니다."
}

 

'정산조회 API' 카테고리의 다른 글

판매대금 정산조회 API  (0) 2026.01.15
배송비 정산조회 API  (0) 2026.01.15