지급대행 웹훅 문의
안녕하세요, seller.changed 웹훅 테스트에 대해 질문 드릴려고 합니다.
v2/sellers api를 통해 테스트 셀러 등록을 했을때 "status" => "PARTIALLY_APPROVED" 상태로 돌아오는데요, seller.changed의 경우 PARTIALLY_APPROVED, KYC_REQUIRED, APPROVED 일때 웹훅이 전송된다고 가이드에 나와있는데, 테스트로 등록한 상점이 PARTIALLY_APPROVED 상태일 경우 1천만원 이상 지급요청을 해야 웹훅 전송 테스트를 할 수 있는걸까요?
아래는 마지막 셀러 등록 테스트 값입니다.
"version" => "1.4"
"traceId" => "60c56b9d8038592cb1c8394dfbba7a9d"
32 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
PARTIALLY_APPROVED 상태일 경우 1천만원 이상 지급요청을 하면 KYC_REQUIRED 를 받아 보실수 있을것 같습니다.
다만 테스트 환경에서 KYC 를 하실수 없어서 APPROVED 로 변경되는 것은 테스트가 불가능합니다.
네 확인했습니다 답변 감사합니다
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.
추가 질문이 있는데 혹시 테스트 환경에서 지금대행한 금액은 실제로 금액이 송금되는게 아닌거죠? 얼마를 테스트하든지 상관없는걸까요?
네 실제 송금은 안되는데요. 1,000만원 넘으면 kyc인증대상으로 막혀서 다시 테스트 불가해요
그러면 지급대행 웹훅을 테스트 해보고 싶은데요
아래와 같이 지급대행에 성공을 했는데 items안에 값이 아무것도 전달되지않았습니다. 테스트 환경에서는 원래 빈값으로 오는게 정상일까요?
"version" => "1.4"
"traceId" => "7ecd6d94282c0fd1d83f90e0888baff0"
"entityBody" => array:1 [▶
"items" => []
]
"entityType" => "payout-list"
"error" => null
그리고 성공했을 경우 payout.changed 웹훅이 전송되어야하는데 전송이 안된듯하네요
로컬환경에서 토스측에서 접근할 수 있도록 IP는 모두 접근 허용을 했으며, 웹훅도 등록을 하였는데 다른 문제가 있을까요?
13.124.18.147
13.124.108.35
3.36.173.151
3.38.81.32
가장 먼저 확인해야 하는건, JWE 암호화가 정상적으로 되었는지 일것 같습니다.
https://docs.tosspayments.com/guides/v2/payouts#%EC%95%94%ED%98%B8%ED%99%94
저희가 v2/payouts 로 들어온 요청을 보았을때, 정상적으로 요청 body 가 decode 가 되지 않습니다. 보통 이 경우는 encode 부터가 잘못 되었을 가능성이 높습니다.
지급대행하기 | 토스페이먼츠 개발자센터
지급대행은 오픈마켓을 운영하는 사업자 대신 토스페이먼츠가 셀러(입점 판매자)에게 대금 지급을 대행 해주는 서비스예요.
아 네, 확인 후 수정했는데 아래와 같이 INVALID_REQUEST 에러코드가 오는데요
어느 부분이 잘못된건지 확인 해주시면 감사하겠습니다.
"version" => "1.4"
"traceId" => "df4f88b4b6a21cbd4a60a004c57e9f41"
"entityBody" => null
"entityType" => null
"error" => array:2 [▶
"code" => "INVALID_REQUEST"
"message" => "필수 파라미터가 누락 또는 요청 형식이 잘못되었습니다."
]
암호화한 데이터도 공유 드립니다.
"
eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIiwiaWF0IjoiMjAyNC0xMC0yOVQxNjo1ODozOSswOTowMCIsIm5vbmNlIjoiZDAxMWZiMjQtZWU2Ni00NTE3LTgyYzQtNGMxNGZkYTc4OGU0In0..uoUn4IRhNGn-OIQS.tBnVI-EH0t7FWJCUvOKYDVkzP4nb4v2uqk4-kRIBsnSsHAH5k5FUKHO6cHD7mXMNjJlw3r9wQoP8S6YQTJUX3Ym49eeJEhqY2o8zXa6iLaonR9a-P3y4GjupUOPNPjc01zPryTpNuw3_kAUjYC6qzI-F-qD90-dPA-lqh0nf81z47m3E3cVxcbMk0pjnqPDK5DaRVx7ZJhx6S_cajfma9mky3Rjv_XhKlVFSePli8ISqmhxPmMOz0nWEgEMSSi9MKysVGYIhBk1W364.CLcBvmXFF33rZs5XAmiQNg
"
이 케이스는
오후 3시가 지나고 express 로 요청 하셔서 그런것 같습니다.
에러 응답은 개선할 수 있도록 내부 확인 중 입니다.
예약지급(SCHEDULED)으로 하고 날짜도 2024-10-31로 설정하였는데 동일한 에러코드 반환합니다
"version" => "1.4"
"traceId" => "c0b2bba28547cf479b428b5e533efe2f"
"entityBody" => null
"entityType" => null
"error" => array:2 [▶
"code" => "INVALID_REQUEST"
"message" => "필수 파라미터가 누락 또는 요청 형식이 잘못되었습니다."
]
"
eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIiwiaWF0IjoiMjAyNC0xMC0yOVQxNzowNjozNSswOTowMCIsIm5vbmNlIjoiZDRiMzBjYzItMTg4Mi00ODc5LTgyY2YtZjMwY2RlMWUzNThkIn0..Giu7pjOLwMlaB4H9.PwlEsUVZArIxPgl4sE3lWDRBxTUq50vvw7dqRv-XWooGbUwPwkCebJhphPYtCUa3nHXc5xpJTqwcaERKsSzyAHXOKj9NIUCNsgbmMilRd8r7gWEHcNsm5o60zgZpOP2sSgg6rSXYVttwwsEBsQ4dmk1NOQBREt6GPIjnDlwGYWezWrosvGk7RKSeLvfDS1oeK4wRM_0jzXjaOYZ0tJAkF0EWJI-bUGEUwBhuZhxucEzQCeL1clSHK005aYG9XiY52tgcZ65VUzp6KuFYgOWaTN-rgyCEhYKGMAaRtg7Kn6nWkbnd6juw.iXFMf4JNiMlJ7jgVJW70-Q
"
음.. 이경우는
transactionDescription":"10\uc6d4\ud14c\uc2a4\ud2b8"
이렇게 전달되어서 문제가 있는것으로 보입니다.
아 transactionDescription도 필수값으로 알고있는데 그러면 어떤 식으로 전달되어야 하는걸까요?
아 이건
해당 파라미터의 값 자체가 "10\uc6d4\ud14c\uc2a4\ud2b8" 이런식으로 넘어온것이 문제인것 같습니다
아 "transactionDescription":"10월테스트" 으로 변환하여 다시 해보았는데요 동일한 에러 발생하는 듯합니다.
"traceId" => "ec7f61265d28dbfef9254064c13d48b2"
array 형태로 보내셔야 하는데 object 형태로 보내신것 같네요.
JSON 앞뒤를 [] 로 싸주시기 바랍니다.
네 array형태로 하니까 잘되네요 감사합니다.
추가로 EXCEEDED_PAYOUT_BALANCE_AMOUNT 에러코드가 전송되었는데요, 지급대행 테스트를 진행하고 싶은데 테스트환경에서 지급 가능한 금액을 설정할 수 있을까요?
MID 를 알려주실수 있을까요/
X_plant_jung 입니다
반영되었습니다. 확인해보시겠어요?
네 확인했습니다 감사합니다. 지급대행을 할 경우 웹훅이 바로 전송되는걸까요? (전송기록이 바로 남는건지) 지급대행요청 테스트 성공을 했는데 전송기록에 아무것도 안남네요, 웹훅 payout.changed 등록은 해놓은 상태입니다
EXPRESS 로 요청하시더라도 저희 내부적으로 실제 지급은 특정 시간 주기로 배치성으로 처리 되기 때문에 웹훅은 뒤늦게 나가고 있어요.
그러면은 오전 10:19분경에 테스트로 지급대행요청을 했었었는데 언제쯤 웹훅 전송될까요? 따로 기록이 남아있는지도 확인 부탁드립니다. "traceId" => "7b550da65849585b864df64c0fa06edc"
express 로 요청 했다면,
오늘 지급이 될 것이고, 지급이 완료된 이후 웹훅 전송 되게 됩니다.
지급 된 이후 웹훅이 발송되는 것 이기 때문에
정확한 시점은 가이드가 어려운점 양해 부탁 드려요.
안녕하세요, 어제자로 테스트키로 express로 지급대행요청을 했었는데요, 오늘 웹훅 전송기록이 남아있지 않아서 재문의드립니다
어제 몇시에 요청하셨어요
?
오전 10:19 입니다
payoutKey 남겨주세요
네 tdpo_a01jbdg3454q2acrbw9t5b64y9z 입니다
sandbox 환경에서 배치 실행이 실패하는 이슈가 있었네요.
15:39 쯤 수동 재실행으로 처리했습니다. 확인 부탁 드립니다.
확인하였습니다 감사합니다