정산
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
dateConditionstring · enumRequiredExample:
정산 조회 기준
PAYOUT_DATEPossible values: nextTokenstringOptionalExample:
다음 페이지를 위한 커서 정보 (직전 호출에서 받은 nextToken을 그대로 넘겨 호출)
eyJpZCI6MTAwMX0=fromDatestring · dateRequiredExample:
조회 시작일자 yyyy-MM-dd 형태
2025-10-06toDatestring · dateRequiredExample:
조회 종료일자 yyyy-MM-dd 형태 (fromDate와 31일 이상 차이날 수 없습니다)
2025-11-05sizeinteger · int32RequiredExample:
페이지 사이즈 (1 ~ 100)
100partnerNamestringOptionalExample:
연동 프로그램명 또는 자사 서비스명
토스쇼핑Responses
200
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
application/json
resultTypestring · enumOptionalPossible values:
응답 결과 타입
get/api/v3/shopping-fep/settlement-steps
GET /api/v3/shopping-fep/settlement-steps?dateCondition=PAYOUT_DATE&fromDate=2026-01-01&toDate=2026-01-01&size=1 HTTP/1.1
Host: shopping-fep.toss.im
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200
모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)
{
"resultType": "SUCCESS",
"error": {
"errorCode": "INVALID_REQUEST",
"reason": "text"
},
"success": {
"items": [
{
"orderId": 10001,
"orderProductId": 12345,
"merchantId": 10001,
"transactionTs": "2025-10-06T14:30:00",
"originTransactionTs": "2025-10-05T10:20:00",
"confirmedAt": "2025-10-13T09:00:00",
"payoutDate": "2025-10-20",
"diffSettlementPayoutDate": "2025-10-25",
"productId": 50001,
"stockId": 333444,
"displayProductName": "리클라이너",
"stockPrice": 50000,
"orderProductStatus": "CONFIRMED_ORDER",
"stepType": "PAY",
"quantity": 2,
"orderProductPrice": 100000,
"orderProductPaidAmount": 95000,
"payFeeRate": "2.5",
"productFeeRate": "5.0",
"payFee": 2375,
"payVat": 238,
"productFee": 4750,
"productVat": 475,
"feeBaseAmount": 7800,
"tossPayDiscount": 3000,
"tossPayPoint": 2000,
"settlementAmount": 87162,
"shoppingDiscount": 5000,
"deliveryFeeAmount": 3000,
"shoppingDiscountToss": 2000,
"shoppingDiscountMerchant": 3000,
"payoutBaseDate": "2025-10-13"
}
],
"nextToken": "eyJpZCI6MTAwMX0="
}
}정산 응답값 샘플
{
"resultType": "SUCCESS",
"success": {
"items": [
// 구매확정 케이스
{
"orderId": 300039,
"orderProductId": 363559,
"merchantId": 10027,
"transactionTs": "2026-01-21 01:41:36",
"originTransactionTs": "2026-01-21 01:41:36",
"confirmedAt": "2026-01-21",
"payoutDate": "2026-01-23",
"diffSettlementPayoutDate": null,
"productId": 138901,
"stockId": 138901,
"displayProductName": "테스트상품1",
"stockPrice": 10800,
"orderProductStatus": "CONFIRMED_ORDER",
"stepType": "PAY",
"quantity": 1,
"orderProductPrice": 10800,
"orderProductPaidAmount": 100,
"payFeeRate": "0.03",
"productFeeRate": "0.072",
"payFee": -23,
"payVat": -2,
"productFee": -561,
"productVat": -56,
"feeBaseAmount": 7800,
"tossPayDiscount": 0,
"tossPayPoint": 7700,
"settlementAmount": 7158,
"shoppingDiscount": 3000,
"deliveryFeeAmount": 0,
"shoppingDiscountToss": 0,
"shoppingDiscountMerchant": 3000,
"payoutBaseDate": "2026-01-21"
},
{
"orderId": 300039,
"orderProductId": null,
"merchantId": 10027,
"transactionTs": "2026-01-21 01:41:36",
"originTransactionTs": null,
"confirmedAt": "2026-01-21",
"payoutDate": "2026-01-23",
"diffSettlementPayoutDate": null,
"productId": null,
"stockId": null,
"displayProductName": "배송비",
"stockPrice": 0,
"orderProductStatus": "",
"stepType": "PAY",
"quantity": 1,
"orderProductPrice": 0,
"orderProductPaidAmount": 0,
"payFeeRate": "0.03",
"productFeeRate": "0.0",
"payFee": 0,
"payVat": 0,
"productFee": 0,
"productVat": 0,
"feeBaseAmount": 0,
"tossPayDiscount": 0,
"tossPayPoint": 0,
"settlementAmount": 0,
"shoppingDiscount": 0,
"deliveryFeeAmount": 0,
"shoppingDiscountToss": 0,
"shoppingDiscountMerchant": 0,
"payoutBaseDate": "2026-01-21"
},
// 환불 케이스
{
"orderId": 284349,
"orderProductId": 343651,
"merchantId": 10027,
"transactionTs": "2025-10-22 17:34:03",
"originTransactionTs": "2025-10-20 12:14:44",
"confirmedAt": "2025-10-21",
"payoutDate": "2025-10-24",
"diffSettlementPayoutDate": null,
"productId": 135165,
"stockId": 135165,
"displayProductName": "테스트상품2",
"stockPrice": 20000,
"orderProductStatus": "CANCELED_PAYMENT",
"stepType": "REFUND",
"quantity": 1,
"orderProductPrice": 20000,
"orderProductPaidAmount": -17520,
"payFeeRate": "0.0",
"productFeeRate": "0.09",
"payFee": 60,
"payVat": 6,
"productFee": 1800,
"productVat": 180,
"feeBaseAmount": 0,
"tossPayDiscount": -2480,
"tossPayPoint": 0,
"settlementAmount": -17954,
"shoppingDiscount": 0,
"deliveryFeeAmount": 0,
"shoppingDiscountToss": 0,
"shoppingDiscountMerchant": 0,
"payoutBaseDate": "2025-10-22"
},
{
"orderId": 284349,
"orderProductId": null,
"merchantId": 10027,
"transactionTs": "2025-10-22 17:34:03",
"originTransactionTs": null,
"confirmedAt": null,
"payoutDate": "2025-10-24",
"diffSettlementPayoutDate": null,
"productId": null,
"stockId": null,
"displayProductName": "배송비",
"stockPrice": 0,
"orderProductStatus": "",
"stepType": "REFUND",
"quantity": 1,
"orderProductPrice": 0,
"orderProductPaidAmount": -4380,
"payFeeRate": "0.0",
"productFeeRate": "0.0",
"payFee": 15,
"payVat": 2,
"productFee": 0,
"productVat": 0,
"feeBaseAmount": 0,
"tossPayDiscount": -620,
"tossPayPoint": 0,
"settlementAmount": -4983,
"shoppingDiscount": 0,
"deliveryFeeAmount": -5000,
"shoppingDiscountToss": 0,
"shoppingDiscountMerchant": 0,
"payoutBaseDate": "2025-10-22"
}
],
"nextToken": "eyJzdGVwTm9DdXJzb3JFeGNsdXNpdmUiOjgzMzU5NzI1LCJkYXRlQ29uZGl0aW9uIjoiUEFZT1VUX0JBU0VfREFURSJ9"
}
}API 연동 중 문의사항이나 개선 제안이 있으신가요?
마지막 업데이트
도움이 되었나요?