빠균•3mo ago

토스 지급대행 API 관련 셀러 인증 오류 및 이용료 문의

안녕하세요, 현재 토스 지급대행을 실 서비스에 연동하여 사용 중입니다. 아래 두 가지 사항에 대해 문의드립니다. 1. 셀러 인증 미진행 시 오류 발생 관련 /v2/payouts API를 통해 주기적으로 여러 셀러의 거래 건을 묶어 지급대행 요청을 하고 있습니다. 그런데, 20명의 셀러 중 일부가 본인인증 절차를 완료하지 않아 아래와 같은 오류가 발생하는 상황입니다.

code: 'FORBIDDEN_SELLER_PAYOUT',
message: 'The seller requires identity verification or customer verification (KYC). Payout requests can only be made for sellers with a status of PARTIALLY_APPROVED or APPROVED (refPayoutId: PAYOUT-17ea4ca8-c2c0-4809-a80c-57fe826cae87)'

code: 'FORBIDDEN_SELLER_PAYOUT',
message: 'The seller requires identity verification or customer verification (KYC). Payout requests can only be made for sellers with a status of PARTIALLY_APPROVED or APPROVED (refPayoutId: PAYOUT-17ea4ca8-c2c0-4809-a80c-57fe826cae87)'

해당 오류 발생 시, 어떤 셀러가 인증을 완료하지 않아 지급대행이 거부되었는지 식별할 수 있는 방법이 있을까요? 2. 월 1,000건 무료 이용 한도 관련 토스 약관을 통해 월 1,000건까지는 지급대행 이용료가 부과되지 않는 것으로 확인했습니다. 이때, 지급대행 요청 중 실패한 건수도 1,000건 무료 한도에 포함되는지 아니면 제외되는지 알고 싶습니다.

8 Replies

토스페이먼츠 BOT•3mo ago

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

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

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

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

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

Kimoon Lee•3mo ago

1. PAYOUT-17ea4ca8-c2c0-4809-a80c-57fe826cae87 로 요청하신 건이 오류가 발생한겁니다. PAYOUT-17ea4ca8-c2c0-4809-a80c-57fe826cae87 로 요청하신 셀러가 인증을 완료하지 않은거구요. ~~2. 월이 아니라 누적 7일입니다.~~ 사용료는 성공건수만 계산합니다.

빠균OP•3mo ago

1. 추가 질문으로 PAYOUT-17ea4ca8-c2c0-4809-a80c-57fe826cae87 으로 요청한 셀러 20개 중 어떤 셀러가 잘못된 셀러인지는 알 수 없다라고 인지하면 될까요? 2. 월 1,000 건이 아니라 일주일 단위로 1,000 건인걸까요? 스크린샷 내용을 참고했었습니다.

김차장•3mo ago

1. refPayoutId 는 각 개별 셀러의 지급건에 매핑됩니다

{"uuid":"SET-TRX-472f7e17-2f27-46c5-86e2-cd5924c96a40","refPayoutId":"PAYOUT-17ea4ca8-c2c0-4809-a80c-57fe826cae87","destination":"seller_a01jv47zrn2jdqszktwt5vvr6vv",(중략)

{"uuid":"SET-TRX-472f7e17-2f27-46c5-86e2-cd5924c96a40","refPayoutId":"PAYOUT-17ea4ca8-c2c0-4809-a80c-57fe826cae87","destination":"seller_a01jv47zrn2jdqszktwt5vvr6vv",(중략)

그래서 어떤 셀러인지 바로 파악 가능하세요 2. 월 1000건의 카운트 기준은 지급이 성공한 건에 해당됩니다

빠균OP•3mo ago

1. 지급대행 요청을 성공한 경우 /api/tossagent/payout/list 에서 refPayoutId 를 확인할 수 있는데, /v2/payouts 에서 실패한경우 response.data 에 string 값이 오고 해당 string 값을 풀어서 보면

{
  version: '2022-11-16',
  traceId: '3186f1a3ec27e9014ae85dd1cd63e7e2',
  entityBody: null,
  entityType: null,
  error: {
    code: 'FORBIDDEN_SELLER_PAYOUT',
    message: 'The seller requires identity verification or customer verification (KYC). Payout requests can only be made for sellers with a status of PARTIALLY_APPROVED or APPROVED (refPayoutId: PAYOUT-d1ce33ae-ed53-42a7-9a06-cf538faedd8d)'
  }
}

{
  version: '2022-11-16',
  traceId: '3186f1a3ec27e9014ae85dd1cd63e7e2',
  entityBody: null,
  entityType: null,
  error: {
    code: 'FORBIDDEN_SELLER_PAYOUT',
    message: 'The seller requires identity verification or customer verification (KYC). Payout requests can only be made for sellers with a status of PARTIALLY_APPROVED or APPROVED (refPayoutId: PAYOUT-d1ce33ae-ed53-42a7-9a06-cf538faedd8d)'
  }
}

이렇게 확인이 됩니다. 실패한 경우의 uuid 를 확인하는 API 가 따로 있나요?

김차장•3mo ago

실패한 경우의 uuid 를 확인하는 API 가 따로 있나요? 이런건 없구요.. 받은 메시지에요 이부분이요

(refPayoutId: PAYOUT-d1ce33ae-ed53-42a7-9a06-cf538faedd8d)'

(refPayoutId: PAYOUT-d1ce33ae-ed53-42a7-9a06-cf538faedd8d)'

빠균OP•3mo ago

아.. refPayoutId 를 저희 쪽에서 만들어서 보내주는 값이라는걸 제대로 인지하지 못하고 질문을 드렸습니다. 죄송합니다. 친절한 답변 감사합니다.

토스페이먼츠 BOT•3mo ago

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

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

토스 지급대행 API 관련 셀러 인증 오류 및 이용료 문의

Did you find this page helpful?