배포 체크리스트

카드 결제를 제공하려면 카드사 심사가 필요해요. 카드사 심사는 각 카드사에서 어떤 서비스를 어떻게 판매하는지 확인하고 카드 결제를 허용해주는 과정이에요. 각 카드사의 결제가 모두 잘 동작하는지는 결제수단별 테스트를 참고해서 테스트 해보세요.

* 주요 카드사: 국민, 삼성, 신한, 현대, 하나, 농협, 비씨, 롯데

휴대폰 결제를 지원하려면 각 이동 통신사 심사를 통과해야 해요. 각 이동 통신사의 결제가 모두 잘 동작하는지는 결제수단별 테스트를 참고해서 테스트 해보세요.

* SKT, LGT, KT

상품권 결제를 지원하려면 모든 종류의 상품권 심사를 모두 통과해야 해요. 각 상품권 결제가 모두 잘 동작하는지는 결제수단별 테스트를 참고해서 테스트 해보세요.

* 상품권: 문화상품권, 도서문화상품권, 게임문화상품권

다음 흐름이 모두 문제없이 진행되는지 확인하세요. 결제 완료, 즉 승인에 성공하면 HTTP 200 OK와 Payment 객체를 받습니다.

1️⃣ 결제창 실행·결제 UI 그리기

☑️ 결제창이 실행되지 않거나 결제 UI가 나타나지 않는다면 브라우저 개발자 도구로 JavaScript 에러가 있지 않은지, 네트워크 탭에서 호출이 실패하는 요청이 있는지 확인하세요.

2️⃣ 선택한 결제수단(카드사 자체창·앱카드 등) 실행

☑️ 모바일 웹 환경에서 카드사·간편결제사 앱이 없다는 메시지가 돌아오고 더이상 진행되지 않거나, 모바일 앱 환경에서 자동으로 앱스토어나 플레이스토어로 이동할 때 카드사나 간편결제사 앱이 다운로드 되어 있는지 확인하세요. 모바일 앱에서 웹뷰를 사용한다면 앱 스킴 리스트와 관련 코드가 제대로 추가되어 있는지 확인하세요.

3️⃣ 상점 브라우저 페이지·상점 앱으로 이동

☑️ 결제 결과에 따라 페이지 이동이 되지 않을 때 successUrl과 failUrl이 올바르게 들어가 있는지 확인하세요.

4️⃣ 결제 완료

☑️ 결제 승인 API가 제대로 요청되었는지 확인하세요.

☑️ 결제 완료 후 페이지 이동까지 구현했다면 결제 결과에 따라 성공 혹은 실패 페이지로 이동하는 흐름도 확인하세요.

결제 취소를 한 뒤 Paymen.status가 CANCELED인지, Payment 객체의 cancels 필드에 취소 객체가 추가됐는지 확인하세요.

부분 취소를 여러 번 한 뒤 다음과 같이 Payment.cancels 필드에 취소 객체가 여러 개 돌아왔는지 확인하세요.

{
  // ...
  "cancels": [
    {
      "cancelAmount": 1000,
      "cancelReason": "고객이 취소를 원함",
      "taxFreeAmount": 0,
      "taxExemptionAmount": 0,
      "refundableAmount": 9000,
      "easyPayDiscountAmount": 0,
      "canceledAt": "2022-01-01T23:23:52+09:00",
      "transactionKey": "8B4F646A829571D870A3011A4E13D640",
      "receiptKey": "CuskOnzZEf0Xbwo8eMZ56slTAXbJ8jUjTX3n6SNuvY5d7Fpf",
      "cancelStatus": "DONE",
      "cancelRequestId": null
    },
    {
      "cancelAmount": 1000,
      "cancelReason": "고객이 다른 품목도 취소를 원함",
      "taxFreeAmount": 0,
      "taxExemptionAmount": 0,
      "refundableAmount": 8000,
      "easyPayDiscountAmount": 0,
      "canceledAt": "2022-01-02T20:00:00+09:00",
      "transactionKey": "6673C15BF350C3F9BF45CEFC48C7A24E",
      "receiptKey": "PLDm1CZSQxTBvYrHytz3yt3MU09Nx57IoCxIEJ8HPzOyIRos",
      "cancelStatus": "DONE",
      "cancelRequestId": null
    }
  ]
  // ...
}

카드 결제의 할부 개월 수와 무이자 여부를 선택했을 때 결제 금액 및 할인 정보가 올바르게 변경됐는지 확인하세요. 결제창 SDK 파라미터로 적용했다면 값이 올바르게 적용되었는지 확인하세요.

Payment.cashReceipts.receiptUrl의 주소로 현금영수증이 발행됐는지 확인할 수 있어요.

개발자센터의 웹훅 목록에서 이벤트 타입이 DEPOSIT_CALLBACK인 웹훅이 등록되어 있는지 확인하세요. 웹훅 이벤트를 등록하는 방법은 웹훅 가이드에서 확인할 수 있어요.

개발자센터의 웹훅 목록에 웹훅이 등록되어 있다면 입금됐을 때, 즉 가상계좌 결제 상태가 바뀌었을 때 웹훅 URL로 알림이 발송돼요.

아래와 같은 이벤트 본문이 등록한 웹훅 URL로 전송됐는지 확인하세요. 이벤트 본문의 secret 값이 결제 승인 응답으로 돌아온 Payment 객체의 secret 값과 같은지도 확인하세요. 값이 같다면 토스페이먼츠 서버에서 돌아온 올바른 요청이에요.

{
  "createdAt": "2022-06-09T15:40:09+09:00",
  "secret": "",
  "status": "DONE",
  "transactionKey": "13CD6AE82C268B57F4E7FB976DC45475",
  "orderId": ""
}

현금영수증은 결제 고객이 가상계좌에 입금한 뒤에 발급돼요. 입금 전에는 현금영수증을 확인할 수 없어요. 테스트 환경에서는 개발자센터의 테스트 거래내역 페이지에서 가장 오른쪽 컬럼의 입금처리・취소 기능으로 실제 동작과 동일하게 테스트 할 수 있어요.

입금 후에는 Payment.cashReceipts.receiptUrl의 주소로 현금영수증이 발행됐는지 확인할 수 있어요.

에스크로 서비스를 계약했는지 확인해 보세요. 배송정보 등록 기능과 구매 확정 기능이 잘 구축되어 있다면 배송이 완료된 후 구매 확정 이메일을 받을 수 있어요. 구매 확정을 선택하면 에스크로를 사용한 결제가 완료돼요. 에스크로 문서를 확인해 보세요.

Chrome, Edge, Firefox, Safari, Whale 환경 각각에서 결제 흐름이 정상적으로 작동하는지 확인하세요. 몇 가지 브라우저만 테스트하면 다른 브라우저에서 발생할 수 있는 문제를 놓칠 수 있어요.

모바일 앱에서 Android와 iOS 환경 각각에 대해 결제 흐름이 정상적으로 이루어지는지, 카드사 앱 및 백신 앱으로의 이동이 잘 이루어지는지 확인하세요.