[API Checkout] Does dueDate parameter apply to all payment methods?
Hello,
I’m currently using the TossPayments API. I’m using the API Checkout Link method for integration (not the SDK).
Question:
When creating a payment, I send the dueDate parameter. I’d like to know whether this dueDate affects all payment methods (CARD, TRANSFER, VIRTUAL_ACCOUNT, MOBILE_PHONE), or if dueDate only applies to Virtual Accounts (가상계좌), while other methods such as CARD, TRANSFER, and MOBILE_PHONE still follow the default 10-minute session timeout?
APIs I’m using:
- POST /v1/payments (create payment)
- then redirecting the user to checkout.url from the response
Thank you.
-----------
[API 결제창] dueDate 파라미터가 모든 결제수단에 적용되나요?
안녕하세요, 토스페이먼츠 API를 연동 중인 개발자입니다.
현재 API 결제창 (Checkout Link) 방식으로 연동하고 있습니다. (SDK 사용 X)
질문:
결제 생성 시
dueDate 파라미터를 설정하면,
모든 결제수단(CARD, TRANSFER, VIRTUAL_ACCOUNT, MOBILE_PHONE)에
결제 만료 시간이 적용되나요?
아니면 dueDate는 가상계좌(VIRTUAL_ACCOUNT)에만 적용되고,
다른 결제수단(CARD, TRANSFER, MOBILE_PHONE)은
기본 세션 타임아웃(10분)만 적용되나요?
사용 중인 API:
- POST /v1/payments (결제 생성)
- 응답의 checkout.url로 결제창 이동
감사합니다.15 Replies
⏳ 잠시만 기다려주세요! 곧 답변드리겠습니다
오류 문의일 경우 아래 정보를 미리 전달해주시면, 빠른 답변에 도움이 됩니다.
- 주문번호(orderId) :
- 문의 내용 :
(문제가 발생한 이미지나 전체 결제흐름 동영상을 첨부해주시면 빠른 분석을 받으실 수 있습니다.)
* 계약관련 내용은 1544-7772로 문의주세요.
* 주말/공휴일에는 답변이 늦을 수 있어요.
Hi there, Thanks for reaching out Toss Payments
The 10-minute session timeout is exist for if user have completed the verification process but server did not call the confirm API.
And for VA, when server calls the confirm API, then the account generated and this account’s due date (closing date) is same as
dueDate that you sent previouslyAll services except virtual accounts operate in real time, so dueDate parameter only applies for virtual account.
In summary, you have to call confirm API within 10 minutes, even it is VA
@Minsu Kim @하사원 Does the 10-minute timeout start when the payment is created on the server, or when the user opens the checkout page?
If it starts when the user opens the checkout page, then regardless of which payment method they choose, the user will have 10 minutes to enter their details and press ‘confirm’ to call the confirm API — is that correct?
No it starts just after redirect to the successURL
@Kimoon Lee So just to confirm: the user can take as long as they want on the checkout page to enter their details. The 10-minute timeout only starts AFTER they complete the verification and get redirected to successURL — then the server must call confirm API within 10 minutes. Is that correct?
the user can take max 20 min on the tosspayment payment window.
@Minsu Kim @하사원 @Kimoon Lee Thank you everyone for helping!
FYI if user takes longer than 20m, the user will see “Session expired” error and stuck at the payment window. In this case, user must refresh or re-access your website/app
@Minsu Kim @Kimoon Lee 안녕하세요. 혹시 20분 고정이 아닌 저희가 임의의 시간을 지정할수 있는 방법이 있을까요 ?
없습니다.
네. 확인 감사드립니다.
네 보안상 고정되어있는 세션시간이라서 양해 바랍니다.
❤️ 기술문의 경험이 어떠셨나요?!
간단히 코멘트 남겨주세요! 제품 발전에 큰 힘이 됩니다.