엔텀페이 비동기식 결제 관련 문의
안녕하세요
엔텀페이 연동 중 문의 드립니다.
1. 웹훅 요청시 금액변조 체크 및 기타 오류 시 어떻게 처리해야 하는지요?
동기식은 최종 승인 API를 호출해야 결제 완료가 되는데
비동기식은 이미 결제완료 된 상태에서 웹훅 호출 되는 것으로 보입니다.
만약 오류 시 환불 처리를 해야하는지 아니면 다른 방법이 있는지요?
2. pendingUrl에서 웹훅 결과값을 계속 체크해서 성공인지 실패인지 체크해야한다는 의미로 판단하면 될런지요?
확인 부탁드립니다.
12 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(img를 함께 첨부해주시면 도움이됩니다)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
1. 환불 처리를 하셔야 합니다.
2. 네 그렇게 해주시면 됩니다.
혹시 페이팔, 엔텀페이 테스트 결제 내역은 상점관리자에서 확인이 안될까요?
라이브 결제 내역은 해외결제 메뉴에서 확인할 수 있습니다.
그럼 테스트 결제내역은 확인할 수 없다는 말씀이시죠?
mid가 어떻게되세요?
linbouk974 입니다.
그리고 환불 요청할때 cancelRequestId 필수 값으로 지정 되어 있는데
해당 값은 저희쪽에서 생성해서 보내야 하는건가요?
테스트결제내역은 아래 페이지에서 확인하실 수 있습니다.
https://developers.tosspayments.com/11288/accounts/1851444/phases/test/payment-logs
테스트 결제내역 | 토스페이먼츠 개발자센터
토스페이먼츠 결제 연동 문서, API, 키, 테스트 내역, 웹훅 등록 등 개발에 필요한 정보와 기능을 확인해 보세요. 결제 연동에 필요한 모든 개발자 도구를 제공해 드립니다.
cancelRequestId 필수 · string
취소 거래를 구분하는 값입니다. 영문 대소문자, 숫자, 특수문자 -, _, =로 이루어진 6자 이상 64자 이하의 문자열을 발급하세요. 각 취소 거래에 고유 값을 발급하세요. 중국 및 동남아(비동기) 결제에만 필수로 사용되는 특수 값입니다.
직접 생성해주시면됩니다
결제 승인 실패 시 메뉴얼에서는
{
"code": "NOT_FOUND_PAYMENT_SESSION",
"message": "결제 시간이 만료되어 결제 진행 데이터가 존재하지 않습니다."
}
이렇게 보내준다고 되어 있는데
실제 10분넘겨서 실패 되게 진행했는데 상태값만 DONE이 아닌 아래처럼 반환 됩니다.
에러 처리가 안된건가요?
{
"createdAt": "2025-10-23T10:20:40.913446",
"eventType": "PAYMENT_STATUS_CHANGED",
"data": {
"mId": "tlinbouk974",
"lastTransactionKey": "B0308FF718709C89FED0CED0F8A9FA7C",
"paymentKey": "tlinb20251023100948ttJG8",
"orderId": "232405209014013599035",
"orderName": "[Test] Jeju Tour Pass 48 Hours + Promotion Code",
"taxExemptionAmount": 0,
"status": "EXPIRED",
"requestedAt": "2025-10-23T10:09:48+09:00",
"approvedAt": null,
"useEscrow": null,
"cultureExpense": false,
"card": null,
"virtualAccount": null,
"transfer": null,
"mobilePhone": null,
"giftCertificate": null,
"cashReceipt": null,
"cashReceipts": null,
"discount": null,
"cancels": null,
"secret": "ps_ex6BJGQOVD9nvQKvmJLJrW4w2zNb",
"type": "NORMAL",
"easyPay": "ALIPAYHK",
"country": "KR",
"failure": null,
"isPartialCancelable": true,
"receipt": null,
"checkout": {
"url": "https://api.tosspayments.com/v1/payments/tlinb20251023100948ttJG8/checkout"
},
"currency": "USD",
"totalAmount": 0.28,
"balanceAmount": 0.28,
"suppliedAmount": 0.25,
"vat": 0.03,
"taxFreeAmount": 0,
"method": "해외간편결제",
"version": "2022-11-16",
"metadata": null
}
}
NOT_FOUND_PAYMENT_SESSION 는 승인 API 에 대한 응답입니다.
앤텀의 경우 승인 API 를 호출하지 않으므로 expire 에 대해 웹훅으로 처리하셔야 하고 해당 웹훅은 지급 받으신 형태로 전달됩니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.