시작하기
6. 테스트와 라이브 전환하기
마지막 단계에서는 연동한 결제 흐름을 시나리오별로 점검하고, 실거래용 API Key로 전환해서 서비스를 오픈해요.
시나리오별로 점검하기
테스트용 API Key는 실제 금원 이동 없이 승인 응답까지 실거래와 동일하게 동작해요. 구매자 인증은 본인 휴대폰의 토스 앱으로 직접 진행하면 되니, 다음 시나리오를 모두 확인해 보세요.
- 결제 생성부터 인증, 승인(또는 자동 승인)까지 완료되고 콜백이 정상 수신되는지 확인해요.
- 구매자가 결제창에서 결제를 중단했을 때
retCancelUrl로 이동하는지 확인해요. - 콜백을 받지 못한 상황을 가정하고 결제 상태 확인 API로 상태를 복구할 수 있는지 확인해요.
- 완료된 결제 건을 환불 API로 전액·부분 환불해 보세요.
현금영수증 발급은 테스트용 API Key로 확인할 수 없어요. 테스트용 Key는 금원이 이동하지 않아 현금영수증이 발급되지 않아요. 현금영수증은 실거래용 API Key로 소액 결제해서 확인한 뒤 반드시 취소 처리하세요.
테스트 중 공격성 요청에 주의하세요. 운영 환경에서 테스트용 API Key를 사용하더라도 순간적으로 요청을 많이 보내면 IP가 자동 차단될 수 있어요.
실거래용 API Key로 전환하기
점검을 마쳤다면 결제 생성 요청의 apiKey를 실거래용(sk_live_)으로 변경하고 서비스를 오픈해요.
오픈 전에 반드시 실거래용 API Key로 변경했는지 확인하세요. 테스트용 API Key로 서비스를 오픈하면 구매자의 결제는 성공한 것처럼 보이지만 실제 출금이 없어서, 가맹점이 금액을 받지 못한 채 상품과 서비스를 제공하게 되는 위험이 있어요.
다음 단계
기본 결제 연동이 끝났어요. 운영에 필요한 기능은 다음 문서에서 확인할 수 있어요.
- 완료된 결제의 전액·부분 환불은 결제 환불하기를 참고하세요.
- 결제 건의 현재 상태 조회는 결제 상태 알아보기를 참고하세요.
- API 응답의 오류 코드 목록은 에러 코드를 참고하세요.
- 자동 결제, 현금영수증, 정산 조회 등 전체 API 명세는 API 레퍼런스를 참고하세요.