누가 무엇을 하나
MeterEngine이 스스로 도는 결제 작업은 결과를 확인하지 못한 결제와 취소의 재조회, 실패한 결제의 재시도, 매일 대사뿐입니다. 모두 도입사가 한 번 요청한 결제를 이어서 처리하는 일이고, 요청한 적 없는 인보이스를 새로 결제하지 않습니다. 예약 작업 시각은 시간 규칙 페이지에 모았습니다.
MeterEngine은 메일을 보내지 않으니 카드 등록 링크와 인보이스 조회 링크는 도입사가 고객에게 직접 전달합니다.
흐름
순서
1
토스페이먼츠 키를 저장한다
토스페이먼츠 개발자센터에서 API 개별 연동 키를 확인해 콘솔 ‘도입사 설정’ 화면에 저장하고, 토스페이먼츠 웹훅 주소를 등록합니다. 토스페이먼츠 상점 준비와 키 저장
2
고객에게 카드를 등록받는다
고객마다 카드 등록 링크를 만들어 전달합니다. 인보이스를 확정하기 전에 해 두어도 됩니다. 고객 카드 등록 링크
3
인보이스를 확정한다
달이 끝난 뒤 인보이스를 확정합니다. 확정한 금액만 결제할 수 있습니다. 인보이스 수동 확정
4
결제를 요청하고 결과를 확인한다
인보이스마다 결제를 요청하고 결과를 확인합니다. 첫 결제 요청과 결과 확인
5
실패와 취소를 처리한다
실패한 결제는 조건에 맞으면 자동으로 다시 시도합니다. 결제 실패와 재시도, 결제 취소
6
고객에게 인보이스를 보여 준다
인보이스 조회 링크를 만들어 고객에게 전달합니다. 고객에게 인보이스 보여 주기
콘솔에서 하는 일과 API로 하는 일
토스페이먼츠 키 저장과 보관은 콘솔에 로그인한 상태에서만 됩니다. API 키로 부르면 거절됩니다. 나머지는 콘솔에서도, API 키로도 할 수 있습니다.
권한의 뜻은 화면과 API, 권한에 있습니다. 엔드포인트의 요청과 응답 형식은 API 참조에서 확인합니다.
업무 환경과 결제 모드
토스페이먼츠 키, 등록 카드, 결제 시도는 업무 환경마다 따로입니다. 테스트 환경은 토스페이먼츠 테스트 키로만 결제하고, 실제 환경은 실결제 키로만 결제합니다. 두 환경을 어떻게 나눠 쓰는지는 테스트 결제와 실결제에 있습니다.토스페이먼츠 키 저장
상점 준비, 키 저장, 토스페이먼츠 웹훅 등록
첫 결제 요청
결제 요청, 결과 읽기, 다시 요청하기 전 확인할 것