가이드

Version 1

결제창 SDK v1은 더 이상 업데이트되지 않습니다. 토스페이먼츠 SDK v2 연동을 추천합니다.

고정 가상계좌는 일반 가상계좌와 달리 특정 고객에게 같은 가상계좌를 반복적으로 발급할 수 있는 계좌입니다. 고객 전용 가상계좌라고 볼 수 있습니다. 고객이 입금한 이후에 고정 가상계좌는 다시 반납되지만, 다시 발급을 요청할 때 같은 accountKey를 보내면 해당 키로 발급됐던 가상계좌가 다시 발급됩니다.

이런 특징 때문에 고정 가상계좌는 accountKey 파라미터를 설정해서 입금하는 고객과 1:1로 매칭해야 합니다.

아래와 같이 accountKey 파라미터를 추가해서 가상계좌 발급 요청 API를 호출하세요. 응답 객체에는 virtualAccount.accountType고정Payment 객체가 돌아옵니다.

고정 가상계좌는 추가 심사 후 사용할 수 있습니다. 토스페이먼츠 고객센터(1544-7772, support@tosspayments.com)로 문의해주세요.

고정 가상계좌 설정 파라미터

  • accountKey string

    고정 가상계좌를 사용하는 고객과 매칭시킨 계좌의 고유한 키 값입니다. 주민등록번호나 휴대폰 번호 등 개인 정보가 특정될 수 있는 값을 포함하면 안됩니다.

  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    실시간 문의|이메일 보내기