afdlkafksd•4d ago

지급대행 완료 웹훅 문의드립니다

API 버젼 1.3 사용중입니다. https://docs.tosspayments.com/guides/payouts#payout_status_changed 이벤트 타입 : PAYOUT_STATUS_CHANGED data.status 값이 "COMPLETED"일때 생성시간(createdAt)을 확인하면 될까요?

정산 지급대행 v1 | 토스페이먼츠 개발자센터

토스페이먼츠 정산 지급대행 v1 API 및 웹훅 스펙입니다. 지급대행은 하위 상점(서브몰)의 정산 금액을 토스페이먼츠가 대신 지급하는 서비스입니다.

38 Replies

토스페이먼츠 BOT•4d ago

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

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

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

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

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

김차장•4d ago

입금완료된 시간 확인이 필요하신거죠? 맞습니다

afdlkafksdOP•4d ago

고객한테 지급대행이 완료되는 일시가 필요해요 네네

김차장•4d ago

네 정확히 일치하지는 않고 배치시간에 따라 시간정보가 늘어질수는 있는데요 입금완료후에 전달되는것은 맞습니다

afdlkafksdOP•4d ago

배치시간 단위를 혹시 알 수 있을까요? 어느정도 차이가 있는지 대략 알 수 있나해서요

김차장•4d ago

매번 다르긴한데요 1시간 안쪽입니다. 웹훅 받고 고객에게 알려주셨을때 고객은 이미 입금을 확인한 후 일수 있어요

afdlkafksdOP•4d ago

알겠습니다. 감사합니다 버젼이 1.3이라서 payout.changed 이벤트는 사용못하죠?

김차장•4d ago

네 맞습니다 앗 잠시만요 사용가능합니다. 지급대행 API 엔드포인트를 v2 로 사용하셔야해요

김차장•4d ago

https://docs.tosspayments.com/reference#%EC%A7%80%EA%B8%89%EB%8C%80%ED%96%89-%EC%9A%94%EC%B2%AD

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

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

afdlkafksdOP•4d ago

아 네 v1로 사용중입니다. 감사합니다

토스페이먼츠 BOT•4d ago

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

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

afdlkafksdOP•3d ago

안녕하세요! 어제 위 질문과 이어서 문의사항이 있습니다. 어제 오후 3시경에 토스 웹훅 목록에 테스트로 확인겸 PAYOUT_STATUS_CHANGED 이벤트, payout.changed 이벤트 둘 다 추가해놓았는데요. 질문 1. 이벤트 등록 후에 다음날부터 이벤트를 받을 수 있나요? 어제랑 오늘 확인했을때 이벤트가 안와서 문의드리려고 했었는데요. 갑자기 오늘 12시 15분부터 갑자기 이벤트가 옵니다. 질문2. /v2로 요청하지 않았는데 payout.changed 이벤트가 옵니다. 어제 문의했을땐 /v2 로 요청해야 온다고 하셨는데 /v1로 요청하는데 이벤트가 와요.

김차장•3d ago

안녕하세요 질문 1. 이벤트 등록 후에 다음날부터 이벤트를 받을 수 있나요? 어제랑 오늘 확인했을때 이벤트가 안와서 문의드리려고 했었는데요. 갑자기 오늘 12시 15분부터 갑자기 이벤트가 옵니다. --> 웹훅 발송 조건이 만족된 시간을 확인해봐야 할거같습니다. 질문2. /v2로 요청하지 않았는데 payout.changed 이벤트가 옵니다. 어제 문의했을땐 /v2 로 요청해야 온다고 하셨는데 /v1로 요청하는데 이벤트가 와요. --> 올바른 사용이 되지 않을것으로 보입니다. v2 로 요청주세요

afdlkafksdOP•3d ago

올바른 사용이 되지 않을것으로 보입니다. v2 로 요청주세요 -> 올바른 사용이 되지 않는다는게 무슨뜻일까요? 현재 /v1로 사용중입니다.

김차장•3d ago

payout.changed 의 웹훅내용을 보면 이렇게 구성되어있는데요

{
  "eventType": "payout.changed",
  "createdAt": "{yyyy-MM-dd'T'HH:mm:ss±hh:mm}",
  "version": "2022-11-16",
  "eventId": "{eventId}",
  "entityType": "payout",
  "entityBody": {
    "id": "FPA_12345",
    "refPayoutId": "my-payout-1",
    "destination": "seller-1",
    "scheduleType": "SCHEDULED",
    "payoutDate": "2024-08-08",
    "amount": {
      "currency": "KRW",
      "value": 5000.0
    },
    "transactionDescription": "8월대금지급",
    "requestedAt": "2024-08-07T22:00:00+09:00",
    "status": "COMPLETED",
    "error": null,
    "metadata": {
      "key1": "value1",
      "key2": "value2"
    }
  }
}

{
  "eventType": "payout.changed",
  "createdAt": "{yyyy-MM-dd'T'HH:mm:ss±hh:mm}",
  "version": "2022-11-16",
  "eventId": "{eventId}",
  "entityType": "payout",
  "entityBody": {
    "id": "FPA_12345",
    "refPayoutId": "my-payout-1",
    "destination": "seller-1",
    "scheduleType": "SCHEDULED",
    "payoutDate": "2024-08-08",
    "amount": {
      "currency": "KRW",
      "value": 5000.0
    },
    "transactionDescription": "8월대금지급",
    "requestedAt": "2024-08-07T22:00:00+09:00",
    "status": "COMPLETED",
    "error": null,
    "metadata": {
      "key1": "value1",
      "key2": "value2"
    }
  }
}

이 형태는 v2 에서 사용하는 방식이에요 반면에 v1 의 PAYOUT_STATUS_CHANGED 는 이렇게 구성되는데요

{
  "eventType": "PAYOUT_STATUS_CHANGED",
  "createdAt": "2022-01-01T00:00:00.000000",
  "data": {
    "payoutKey": "zhOrWUKGOzewTsDIjBBGk",
    "subMallId": "testmall100",
    "payoutDate": "20220103",
    "payoutAmount": 10000,
    "requestedAt": "20220101100130",
    "account": {
      "bankCode": "03",
      "accountNumber": "00123412341234",
      "holderName": null
    },
    "status": "COMPLETED",
    "metadata": null,
    "failure": null,
    "transferSummary": null
  }
}

{
  "eventType": "PAYOUT_STATUS_CHANGED",
  "createdAt": "2022-01-01T00:00:00.000000",
  "data": {
    "payoutKey": "zhOrWUKGOzewTsDIjBBGk",
    "subMallId": "testmall100",
    "payoutDate": "20220103",
    "payoutAmount": 10000,
    "requestedAt": "20220101100130",
    "account": {
      "bankCode": "03",
      "accountNumber": "00123412341234",
      "holderName": null
    },
    "status": "COMPLETED",
    "metadata": null,
    "failure": null,
    "transferSummary": null
  }
}

사용하는 키값이나 필드명이 조금씩 다릅니다

afdlkafksdOP•3d ago

아 네네 그 말이셨군여

김차장•3d ago

넵넵

afdlkafksdOP•3d ago

제가 궁금했던건,,, /v2로 요청하지 않았는데 payout.changed 이벤트가 옵니다. 어제 문의했을땐 /v2 로 요청해야 온다고 하셨는데 /v1로 요청하는데 이벤트가 와요.

김차장•3d ago

웹훅 이벤트를 payout.changed 로 등록하셨나요?

afdlkafksdOP•3d ago

"payout.changed, PAYOUT_STATUS_CHANGED 둘 다 등록했어요 확인차 등록해보았습니다

김차장•3d ago

그러면 PAYOUT_STATUS_CHANGED 만 사용하시는게 맞는 사용이에요 payout.changed 이벤트 구독이 되어있어서 오는거같습니다

afdlkafksdOP•3d ago

아 네네

김차장•3d ago

v1 으로 사용하시는거면 payout.changed 를 구독해지해주세요

afdlkafksdOP•3d ago

알겠습니다 그리고 질문1 답변 주신거 "--> 웹훅 발송 조건이 만족된 시간을 확인해봐야 할거같습니다."

김차장•3d ago

네네

afdlkafksdOP•3d ago

혹시 웹훅 발송 조건 체크하는 시간은 하루 정해져 있는 시간이 있나요?

김차장•3d ago

아뇨, 비즈니스로직이 갖춰지면 바로 자동발송이에요 어제 안오고 오늘 받으셨다는건 좀 이상해요 어제 웹훅 등록 후 웹훅을 받을 수 있는 다른 진행도 하셨던거죠? 라이브 지급요청 등

afdlkafksdOP•3d ago

아니요 그냥 다른 진행은 따로 안했고, 이벤트 확인용으로 등록했습니다. 2025-02-19 일자 지급대행 요청 드린 건들이라 2025-02-20에 지급 완료된 것으로 보이는데요. 혹시 payoutKey로 PAYOUT_STATUS_CHANGED 이벤트가 전송이 되었는지 확인이 가능할까요? tdpo_a01jmez95z5b51xsp0m0kk7r6nt tdpo_a01jmez95z5207vb6j6kst80nds tdpo_a01jmezepnqg9ewcr7wtvv7s1vm

김차장•3d ago

네 확인해볼게요

Kimoon Lee•3d ago

v1 이면 실시간 지급이 되지 않고 요청하신 날짜에 11~2시 사이에 일괄 지급되어서 12시 15분경에 전달된게 아닌가 싶은데요. 이부분 확인부탁드립니다. PAYOUT_STATUS_CHANGED 는 실제 지급이 되고 나서 발생하는 이벤트입니다.

afdlkafksdOP•3d ago

혹시 제가 어디에서 확인하면 될까요?

김차장•3d ago

지급요청을 어제 하신거면 오늘 받으시는것이 맞습니다 2/21에 지급한다는 요청을 2/20에 하셨다면 지급이 발생한 2/21에 웹훅을 받으시는것이 맞습니다 2/21에 받는 지급요청이었는지 확인해주시면 될거같아요

Kimoon Lee•3d ago

,{"payoutKey":"tdpo_a01jmez95z5b51xsp0m0kk7r6nt","requestId":null,"subMallId":"","payoutDate":"20250220" 보내주신 것중에 처음 것을 이렇게 요청 주셨는데요. 2월 20일에 지급요청을 하셨고 그래서 2월 20일에 지급한후에 웹훅 보내드렸습니다. 이상한 점이 있으실까요?

afdlkafksdOP•3d ago

subMallId 아이디 지워주실 수 있나요? 제가 어제 2월 20일 오후 3시경 웹훅을 등록했는데 일괄 지급이 11-2시에 된거면 못받앗을수도 있겟네요

Kimoon Lee•3d ago

아. 그말씀을 하신거군요. 네 해당 케이스의 경우 20일 12시 45분에 지급되었습니다.

afdlkafksdOP•3d ago

네네 저는 실시간 지급으로 시간을 생각했는데 아니였나봅니다. 감사합니다

Kimoon Lee•3d ago

네 v1 의 경우 지급날짜를 정하시는 방식이고 지급요청하신 날짜의 정해진 시간에 일괄 지급처리 됩니다.

afdlkafksdOP•3d ago

아 네네 정말 감사합니다!

지급대행 완료 웹훅 문의드립니다

Did you find this page helpful?