토스 단말 접수와 결제 연동
토스 프론트 플러그인에서 고객과 예약을 조회하고, 단말에서 요청한 결제의 승인 결과를 구매 기록에 저장합니다.
제공 완료 확인
고객 조회, 결제 승인, 결제 중단과 시간 초과, 승인 후 기록 저장과 재시작 시 복구를 대상 단말에서 시험합니다.
다른 항목과의 구분
이 플러그인에서 요청한 결제를 대상으로 합니다. 다른 POS 거래 수집, 환불과 부분 취소의 자동 처리, 광고 전환 취소는 포함하지 않습니다. 실제 매장 개통은 단말 시험 후 확인합니다.
토스 단말에서 접수하고 결제 확인하기
[blocked]플러그인에서 접수와 결제 요청을 이어서 수행한다.
시작 조건과 입력
매장 연결과 시험 결제 담당자를 확인하세요. 실제 승인 가능한 결제 절차입니다.
- 토스 매장과 플러그인 연결하기: 단말을 처음 사용하거나 매장이 바뀔 때
이 작업에 사용할 값
entry_url, terminal_id, customer_id, amount, purchase_id, transaction_url
커맨드 시퀀스
ref 대상과 확인할 결과
결과 확인
고객, 거래 식별자, 금액과 승인 결과가 서로 일치합니다.
중단 후 다시 시작하기
접수 ID와 원래 요청의 처리 결과를 먼저 확인하세요. 결과를 확인할 수 없다면 같은 요청을 새로 제출하지 않습니다.
[blocked]시험 거래 준비
시험 가능한 단말과 담당자가 승인한 시험 거래를 준비하세요. 상품, 수량, 금액과 취소 처리 방법을 미리 정합니다. 화면 시연만 필요한 경우 실제 결제 승인을 실행하지 않고 그 범위를 명시하세요.
[blocked]고객 접수
플러그인에서 고객을 조회하고 이름 외의 식별 정보로 대상이 맞는지 확인하세요. 접수할 예약이나 고객 정보를 확인합니다. 동명이인이 있으면 원본 고객 기록을 대조한 뒤 다음 단계로 이동하세요.
[blocked]결제 요청과 승인
선택한 상품과 결제 금액을 확인하고 단말의 결제 요청을 진행하세요. 결제 승인 결과가 나올 때까지 같은 거래를 다시 요청하지 마세요. 오류가 나면 거래 식별자와 시각을 남겨 승인 여부부터 확인합니다.
[blocked]구매 기록 대조
Laney 구매 기록의 고객, 상품, 금액과 상태를 단말 승인 결과와 대조하세요. 저장 상태와 승인 결과가 다르면 복구 문서로 이동합니다. 시험 거래를 취소했다면 실제 취소 결과와 구매 기록도 별도로 확인하세요.
토스 매장과 플러그인 연결하기
[blocked]매장, 단말과 Laney 조직의 연결을 확인한다.
시작 조건과 입력
단말 매장 정보와 연결할 Laney 조직을 확인하세요.
이 작업에 사용할 값
entry_url, organization_id, merchant_id, terminal_id, reception_url
커맨드 시퀀스
ref 대상과 확인할 결과
결과 확인
다른 조직의 고객을 대상으로 접수가 시작되지 않습니다. 결제 시험은 별도로 진행합니다.
중단 후 다시 시작하기
다시 시작할 때 같은 ID의 현재 값을 읽으세요. 이미 맞게 저장된 설정은 유지하고 다른 값만 수정합니다.
[blocked]매장과 조직
토스 매장 식별 정보와 연결할 Laney 조직을 담당자와 대조하세요. 여러 지점이 있으면 매장별 조직을 구분합니다. 단말 설치 완료와 플러그인 계정 연결 완료는 별도로 확인합니다.
[blocked]플러그인 초기 설정
설치된 Laney 플러그인을 열고 담당자가 안내한 초기 연결을 진행하세요. 표시되는 매장과 조직을 확인한 뒤 설정을 저장합니다. 다른 지점이 표시되면 접수나 결제를 진행하기 전에 연결을 수정하세요.
[blocked]직원 접근
단말에서 작업할 직원의 조직 접근 권한을 확인하세요. 고객 조회와 구매 기록 확인에 필요한 범위만 부여합니다. 단말을 사용할 수 있다는 사실만으로 다른 지점의 고객 데이터도 볼 수 있는 것은 아닙니다.
[blocked]연결 결과 확인
시험 고객을 조회하고 플러그인에서 시작하는 접수와 결제 흐름을 확인하세요. 이 연동의 대상은 플러그인에서 시작한 거래입니다. 매장의 모든 POS 거래가 자동으로 동기화되는 것으로 보지 마세요.
토스 결제 결과가 다를 때 확인하기
[blocked]단말 승인과 Laney 기록이 다른 경우 중복 결제를 막으며 원인을 좁힌다.
시작 조건과 입력
새 결제를 요청하지 말고 원래 거래의 식별 정보를 확보하세요.
이 작업에 사용할 값
entry_url, merchant_id, transaction_id, purchase_id, amount, transaction_url
커맨드 시퀀스
ref 대상과 확인할 결과
결과 확인
같은 거래가 중복 결제 없이 기록되었거나 미해결 상태로 인계되었습니다.
중단 후 다시 시작하기
접수 ID와 원래 요청의 처리 결과를 먼저 확인하세요. 결과를 확인할 수 없다면 같은 요청을 새로 제출하지 않습니다.
[blocked]같은 거래 찾기
매장, 고객, 거래 시각, 금액과 단말 거래 식별자를 모으세요. 비슷한 시간의 다른 거래와 혼동하지 않도록 Laney 구매 ID도 함께 기록합니다. 플러그인에서 시작한 거래인지 확인하세요.
[blocked]승인과 저장 상태 대조
단말이나 공급자의 승인 결과를 원본으로 확인하세요. 이어서 Laney 구매의 상태와 금액을 대조합니다. 화면이 멈췄다는 이유로 결제가 실패했다고 단정하지 마세요. 승인됨, 거절됨, 확인되지 않음을 구분합니다.
[blocked]재확인과 복구
승인이 확인되었는데 저장 결과만 없으면 같은 금액을 다시 결제하지 마세요. 거래 식별자와 기록을 연결 담당자에게 전달해 저장 결과를 확인합니다. 재시도는 기존 거래 상태와 중복 방지 방법을 확인한 뒤 진행하세요.
[blocked]취소와 환불의 범위
구매 상태를 취소로 바꾸는 것은 카드 환불을 실행하는 기능이 아닙니다. 환불과 부분 취소는 공급자 처리 결과를 확인하고 구매 기록을 대조하세요. 모든 단말 거래의 취소가 자동 동기화되는 것으로 가정하지 마세요.