Avengers•3w ago

지급대행 중복 요청 사례 문의

안녕하세요. 금일 정산 대사 수행 중 이전에 본 적이 없는 사례가 발생하여 문의 드립니다. 동일한 셀러에 같은 금액으로 중복 요청이 이루어졌고, 실제 지급도 중복으로 입금이 되었습니다. 당일 동일 셀러에게 1회만 되는 걸로 알고 있는데 확인 요청드립니다. (2회 이상 요청 시 DUPLICATED_REQUEST 에러) 참고로 해당 요청은 지급대행 V1으로 요청되었고, 당일 지급으로 요청되었습니다. 연휴 끝나고 바쁘실텐데 이번주 문의를 많이 드리네요.. 감사합니다.

{
    "version": "2022-06-08",
    "traceId": "a57fd71384364d73c1e775b2f9b3188a",
    "entityBody": {
        "id": "tdpo_a01jk740989q0z18qzt1t9nrfjw",
        "refPayoutId": null,
        "amount": {
            "currency": "KRW",
            "value": 1696320.00
        },
        "destination": "seller_a01jhsfxtgp0rw63s20t5jxskwp",
        "error": null,
        "metadata": null,
        "payoutDate": "2025-02-04",
        "requestedAt": "2025-02-04T08:58:18+0900",
        "scheduleType": "EXPRESS",
        "status": "COMPLETED",
        "transactionDescription": "***"
    },
    "entityType": "payout",
    "error": null
}

{
    "version": "2022-06-08",
    "traceId": "a57fd71384364d73c1e775b2f9b3188a",
    "entityBody": {
        "id": "tdpo_a01jk740989q0z18qzt1t9nrfjw",
        "refPayoutId": null,
        "amount": {
            "currency": "KRW",
            "value": 1696320.00
        },
        "destination": "seller_a01jhsfxtgp0rw63s20t5jxskwp",
        "error": null,
        "metadata": null,
        "payoutDate": "2025-02-04",
        "requestedAt": "2025-02-04T08:58:18+0900",
        "scheduleType": "EXPRESS",
        "status": "COMPLETED",
        "transactionDescription": "***"
    },
    "entityType": "payout",
    "error": null
}

{
    "version": "2022-06-08",
    "traceId": "b99a9d9937319f83250ca69ba984807c",
    "entityBody": {
        "id": "tdpo_a01jk740a245y17bprmt6e5063w",
        "refPayoutId": null,
        "amount": {
            "currency": "KRW",
            "value": 1696320.00
        },
        "destination": "seller_a01jhsfxtgp0rw63s20t5jxskwp",
        "error": null,
        "metadata": null,
        "payoutDate": "2025-02-04",
        "requestedAt": "2025-02-04T08:58:19+0900",
        "scheduleType": "EXPRESS",
        "status": "COMPLETED",
        "transactionDescription": "***"
    },
    "entityType": "payout",
    "error": null
}

{
    "version": "2022-06-08",
    "traceId": "b99a9d9937319f83250ca69ba984807c",
    "entityBody": {
        "id": "tdpo_a01jk740a245y17bprmt6e5063w",
        "refPayoutId": null,
        "amount": {
            "currency": "KRW",
            "value": 1696320.00
        },
        "destination": "seller_a01jhsfxtgp0rw63s20t5jxskwp",
        "error": null,
        "metadata": null,
        "payoutDate": "2025-02-04",
        "requestedAt": "2025-02-04T08:58:19+0900",
        "scheduleType": "EXPRESS",
        "status": "COMPLETED",
        "transactionDescription": "***"
    },
    "entityType": "payout",
    "error": null
}

8 Replies

토스페이먼츠 BOT•3w ago

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

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

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

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

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

OMG•3w ago

네 확인해보겠습니다.

AvengersOP•3w ago

안녕하세요. 혹시 확인이 되셨을까요?

OMG•3w ago

아직 상세 내역 확인중입니다. 우선 말씀하신 아래 상태는 맞습니다.

동일한 셀러에 같은 금액으로 중복 요청이 이루어졌고, 실제 지급도 중복으로 입금이 되었습니다.

당일 동일 셀러에게 1회만 지급이 허용되었던 것은 예전 초기 v1 스펙에만 있던 것으로 기억하는데요. 지금 추가 확인중인 내용은 DUPLICATED_REQUEST 에러가 발생하는 기준과, 이번에는 왜 해당하지 않았는지 체크중입니다. 지급대행 관련 문의에 대한 답변은 조금 시간이 걸리는 점 양해 부탁 드릴게요. 확인한 내용 전달 드립니다. 현재 지급대행 v1 인터페이스로 호출이 들어오지만 내부적으로 v2 도메인 로직을 통해 처리하고 있는데요 refPayoutId 기반의 중복 체크 로직은 v2 오픈 API 인터페이스로 인입된 경우만 동작하고 있었습니다. 따라서 현재 중복 체크가 없는 상황과 동일한 것 같습니다.

OMG•3w ago

중복 지급 없이 처리하기 위해서는 멱등키를 요청 헤더에 추가하는 방법으로 진행 부탁 드립니다. https://docs.tosspayments.com/reference/using-api/authorization#멱등키-헤더

인증 및 기타 헤더 설정 | 토스페이먼츠 개발자센터

토스페이먼츠 API를 사용하기 위해 필요한 인증과 헤더 설정 방법입니다.

AvengersOP•3w ago

안녕하세요. 답변 감사드립니다. 정리하자면 이전에는 멱등키 헤더가 없어도 중복 요청 시 1회 이후의 모든 요청은 거절이 되었는데, 현재는 로직이 변경되어 멱등키 헤더가 없으면 당일 동일 요청에 대해서도 입금이 되는 것이 정상이다는 말씀으로 이해하면 될까요?

OMG•3w ago

네 맞습니다. v1 에도 중복체크 추가될 수 있도록 수정이 될 예정이긴 합니다. 다만 큰 맥락에서 보안성 측면을 염두에 두고 있기에 일정기간(미정) 이후 v1 -> v2 로 전환을 하게 될 겁니다.

토스페이먼츠 BOT•3w ago

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

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

지급대행 중복 요청 사례 문의

Did you find this page helpful?