이현준•12mo ago

결제취소 건의 정산 데이터 관련 문의

안녕하세요, 정산 API 응답값 관련하여 질문사항이 있습니다. 정산 API 예제 (https://docs.tosspayments.com/reference#%EC%A0%95%EC%82%B0-%EC%A1%B0%ED%9A%8C) response에서 결제취소 건은 다음과 같습니다.

[
  {
    "mId": "tosspayments",
    "paymentKey": "xLpgeoO7410238740297423RBKEzMjPJyG",
    "transactionKey": "497BF239847238947B0491D84B4",
    "orderId": "EjBNtZK7j8q2TlGFLJ-9T",
    "currency": "KRW",
    "method": "카드",
    "fees": [
      {
        "type": "BASE",
        "fee": -2250
      },
      {
        "type": "ETC",
        "fee": 0
      }
    ],
    "approvedAt": "2023-11-25T13:03:39+09:00",
    "soldDate": "2023-11-25",
    "paidOutDate": "2023-11-30",
    "card": {
      "issuerCode": "11",
      "acquirerCode": "11",
      "number": "55704251****800*",
      "installmentPlanMonths": 3,
      "isInterestFree": true,
      "interestPayer": "CARD_COMPANY",
      "approveNo": "30024234",
      "useCardPoint": false,
      "cardType": "신용",
      "ownerType": "개인",
      "acquireStatus": "READY",
      "amount": 99800
    },
    "virtualAccount": null,
    "transfer": null,
    "mobilePhone": null,
    "giftCertificate": null,
    "easyPay": null,
    "cancel": {
      "transactionKey": "497BF239847238947B0491D84B4",
      "cancelReason": "주문취소",
      "taxExemptionAmount": 0,
      "canceledAt": "2023-11-25T13:40:03+09:00",
      "easyPayDiscountAmount": 0,
      "receiptKey": null,
      "cancelAmount": 99800,
      "taxFreeAmount": 0,
      "refundableAmount": 0,
      "cancelStatus": "DONE",
      "cancelRequestId": null
    },
    "amount": -99800,
    "interestFee": 0,
    "fee": -2250,
    "supplyAmount": -2045,
    "vat": -205,
    "payOutAmount": -97550
  }
]

[
  {
    "mId": "tosspayments",
    "paymentKey": "xLpgeoO7410238740297423RBKEzMjPJyG",
    "transactionKey": "497BF239847238947B0491D84B4",
    "orderId": "EjBNtZK7j8q2TlGFLJ-9T",
    "currency": "KRW",
    "method": "카드",
    "fees": [
      {
        "type": "BASE",
        "fee": -2250
      },
      {
        "type": "ETC",
        "fee": 0
      }
    ],
    "approvedAt": "2023-11-25T13:03:39+09:00",
    "soldDate": "2023-11-25",
    "paidOutDate": "2023-11-30",
    "card": {
      "issuerCode": "11",
      "acquirerCode": "11",
      "number": "55704251****800*",
      "installmentPlanMonths": 3,
      "isInterestFree": true,
      "interestPayer": "CARD_COMPANY",
      "approveNo": "30024234",
      "useCardPoint": false,
      "cardType": "신용",
      "ownerType": "개인",
      "acquireStatus": "READY",
      "amount": 99800
    },
    "virtualAccount": null,
    "transfer": null,
    "mobilePhone": null,
    "giftCertificate": null,
    "easyPay": null,
    "cancel": {
      "transactionKey": "497BF239847238947B0491D84B4",
      "cancelReason": "주문취소",
      "taxExemptionAmount": 0,
      "canceledAt": "2023-11-25T13:40:03+09:00",
      "easyPayDiscountAmount": 0,
      "receiptKey": null,
      "cancelAmount": 99800,
      "taxFreeAmount": 0,
      "refundableAmount": 0,
      "cancelStatus": "DONE",
      "cancelRequestId": null
    },
    "amount": -99800,
    "interestFee": 0,
    "fee": -2250,
    "supplyAmount": -2045,
    "vat": -205,
    "payOutAmount": -97550
  }
]

해당 데이터의 정산 주기가 하루인지 한주인지는 모르겠지만, 결제승인 일시는 2023-11-25T13:03:39+09:00 이고 취소 일시는 2023-11-25T13:40:03+09:00 입니다. 37분 안에 취소되어서 정산지급일이 지나지 않은 건인데, 지급금액 데이터인 payOutAmount 값이 음수로 나오는 이유가 궁금합니다. 예제 데이터라 기입이 잘못된 것인지, 실제 API에서도 취소 건은 payOutAmount 값이 음수로 나오는지 궁금합니다

코어 API | 토스페이먼츠 개발자센터

토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.

7 Replies

토스페이먼츠 BOT•12mo ago

⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다

오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.

- 주문번호(orderId) : - 문의 내용 :

(img를 함께 첨부해주시면 도움이됩니다)

* 계약관련 내용은 1544-7772로 문의주세요. * 주말/공휴일에는 답변이 늦을 수 있어요.

이현준OP•12mo ago

정산지급이 되지 않아서 payOutAmount 값은 0이 되어야할 것 같은데 혹시 해당 값은 실제로 정산지급된 값하고는 관련없는 필드인지도 궁금합니다

today.lastday•12mo ago

정산대사에는 승인건과 취소건이 모두 표시됩니다. 해당 결과는 취소건만 봐서 그런데 승인건에도 payOutAmount가 있습니다. 두 값을 더하면 0이 됩니다.

이현준OP•12mo ago

정산 부분에서 추가 질문드립니다. 1. 토스페이먼츠 -> 상점 에게 정산이 완전 완료된 결제 건의 경우 취소가 가능한지 궁금합니다. 2. 추가적으로, 만약 1번이 가능하다고 한다면 다음 경우에서 정산 조회 API(https://docs.tosspayments.com/reference#%EC%A0%95%EC%82%B0-%EC%A1%B0%ED%9A%8C) 값이 어떻게 조회되는지 궁금합니다. ㄱ. 1월4일 고객 결제완료 ㄴ. 1월 7일 정산지급일 및 정산지급 완료 ㄷ. 1월 10일 고객 결제취소 ㄴ과 ㄷ 사이 시기에 정산 지급일 기준으로 정산 데이터 조회를 한다면 승인건의 정산 데이터 1개가 조회될 것으로 예상되고, ㄷ 시기 이후에 정산 지급일 기준으로 정산 데이터 조회를 한다면 승인건, 취소건 해서 총 2건의 정산 데이터가 조회될 것으로 예상되는데 예상이 맞는지 문의드립니다.

코어 API | 토스페이먼츠 개발자센터

토스페이먼츠 API 엔드포인트(Endpoint)와 객체 정보, 파라미터, 요청 및 응답 예제를 살펴보세요.

today.lastday•12mo ago

1. 당연히 가능합니다. 2. 예상하신 것처럼 승인 1건이 조회되고, 취소 1건이 조회됩니다. 정산데이터는 일단위로 생성되기 때문에 일자를 맞춰 대사해야 합니다.

이현준OP•12mo ago

답변 감사드립니다! 궁금한 부분이 모두 해결되었습니다

토스페이먼츠 BOT•12mo ago

❤️ 기술문의 경험이 어떠셨나요?!

간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.

결제취소 건의 정산 데이터 관련 문의

Did you find this page helpful?