토스페이먼츠

토스페이먼츠로 설정한 경우

이 매뉴얼은 토스페이먼츠 API에 관한 내용입니다.

구버전인 Xpay 모듈 매뉴얼이 필요하신 경우 토스페이먼츠(구버전) 매뉴얼을 확인해주시기 바랍니다.

  토스페이먼츠(구버전) 매뉴얼 : https://sir.kr/manual/yc5/182

토스페이먼츠

상점 아이디

토스페이먼츠에서 받은 si_로 시작하는 상점 ID를 입력하세요.

만약, 상점 ID가 si_로 시작하지 않는다면 토스페이먼츠에 사이트코드 변경 요청을 하세요.

예) si_tosspayment

토스페이먼츠 API - Client Key/ Secret Key

토스페이먼츠 API 키는 [개발자센터] > [상점선택] > [API 키]에서 확인할 수 있습니다.

테스트 결제 시에는 [테스트] API 키를 입력해주시고,

운영 환경에서는 실제 결제를 위해 [라이브] API 키를 입력하시기 바랍니다.

상품 구매 시 결제에서 토스페이먼츠는 아래와 같이 표시됩니다.

'PG사 간편결제 버튼 사용'에서 '노출함'에 체크해야만 표시됩니다.

가상계좌 입금통보 URL

가상계좌 연동 시 입금통보를 받고 싶을 경우 아래와 같이 웹훅을 연동해주시기 바랍니다.

토스페이먼츠 가상계좌 사용시, 입금통보 주소를 [토스페이먼츠 개발자센터]-[상점 선택]-[웹훅]-[웹훅 등록하기]-[URL]에 입력 후 구독할 이벤트를 [DEPOSIT_CALLBACK]으로 선택하여 등록하면 상점에 자동으로 입금 통보됩니다.

입금통보 주소 예시 : https://도메인주소/shop/settle_toss_common.php

  토스페이먼츠 개발자센터 : https://developers.tosspayments.com/my/api-keys

1) 입금 오류가 발생할 경우

가상계좌 입금오류는 주로 입금 금액이 주문 금액과 다르거나, 계좌 만료 후 입금한 경우에 발생합니다.
이 경우 토스에서 [입금완료] 후 [입금오류] 순서로 통보가 오므로 반드시 최종 상태를 확인해야 합니다.

입금오류 발생 시에는 SMS 알림을 설정한 경우에만 고객에게 SMS가 발송됩니다.

입금 오류가 발생했을 경우 [주문내역수정] > [상점메모]에서 확인할 수 있습니다.

결제 테스트

테스트 결제를 진행할 때는 상점 API 키를 반드시 [테스트] 키로 변경하여 실행하십시오.

키를 변경하지 않으면 테스트 환경에서도 실제 결제가 진행됩니다.
실제 결제를 진행할 때는 [라이브] 키를 사용해 운영하십시오.

1) 테스트 결제 시 영수증

테스트 결제 시에는 영수증 링크가 제공되지 않습니다.

(해당 영수증 종류 : 신용카드, 휴대폰, 현금영수증)

2) 에스크로

에스크로는 실제 결제 환경에서만 확인 가능하며, 사전에 에스크로 서비스에 가입해야 이용할 수 있습니다.

(지원 결제수단: 신용카드, 가상계좌, 계좌이체)

구매확정 이전에는 부분 취소가 불가합니다. 전체 취소 후 일부 금액을 재결제하거나, 구매 확정 이후에 부분 취소를 진행하시기 바랍니다.

관리자 결제 취소

결제수단 중 가상계좌를 제외한 모든 수단은 연동을 통해 관리자 화면에서 결제 취소가 가능합니다.
가상계좌 결제는 관리자 화면에서 직접 취소가 불가하므로 토스페이먼츠 상점관리자를 통해 진행해야 합니다.

  토스페이먼츠 상점관리자 : https://app.tosspayments.com/