키인 결제 추가하기

✅ 카드 번호만으로 간단히 결제하고 싶을 때

✅ 법인카드와 같이 고객 명의로 발급되지 않은 카드로 결제하고 싶을 때

상점관리자의 결제 UI 설정 메뉴에서 UI 환경을 선택해주세요. 선택 후 기능 > 결제수단 목록 메뉴 하단에 있는 + 추가하기 버튼을 눌러주세요. 팝업창에서 키인 결제를 선택해서 사용하고 싶은 상점아이디(MID)를 선택하고, 결제 UI에 표시될 이름을 입력하세요.

결제수단으로 법인카드를 추가하고 '법인카드'로 이름을 설정하면 결제창에 아래와 같이 표시됩니다.

1. 결제위젯 연동하기 가이드를 따라서 결제수단을 렌더링하세요.

2. 결제 요청이 성공하면 성공 페이지로 이동합니다. 고객이 키인 결제를 했다면 성공 페이지 URL의 paymentType 쿼리 파라미터가 KEYIN으로 돌아옵니다.

   https://my-store.com/success?paymentType=KEYIN&paymentKey={PAYMENT_KEY}&orderId={ORDER_ID}&amount={AMOUNT}
   

3. 결제 승인 API를 호출할 때 키인 결제 상점아이디(MID)의 시크릿 키를 사용하세요.

   시크릿 키 뒤에 :을 추가하고 base64로 인코딩합니다. 콜론을 빠트리지 않도록 주의하세요.

   echo -n '{KEYIN_SECRET_KEY}' + ':' | base64
   

   인코딩된 값을 Basic 인증 헤더에 넣고 요청 본문도 추가하세요.

   요청

   curl --request POST \
     --url https://api.tosspayments.com/v1/payments/confirm \
     --header 'Authorization: Basic {ENCODED_KEYIN_SECRET_KEY}' \
     --header 'Content-Type: application/json' \
     --data '{"paymentKey":"{PAYMENT_KEY}","amount":15000,"orderId":"rJVnEK_iFcvQ3gk-Ls5xJ"}'

   cURL

   cURLJavaNode.jsC#PHPPythonRubyKotlin

4. 결제 승인에 성공하면 HTTP 200 OK와 Payment 객체를 받습니다.