💸3. 결제 요청하기

파라미터값을 조합하여 결제창을 호출 할 수 있습니다.

IMP 객체 초기화가 완료 되었으면 이제 결제창을 호출할 차례입니다.

결제창 호출시 필요한 파라미터를 request_pay 함수 첫번째 파라미터 인자로 설정합니다.

카드사 프로모션 인증결제를 진행하기 위해서는 현재 프로모션 이벤트 진행중인 카드사 모듈을 바로 호출하는 형태로 결제창을 활성화 시켜야 합니다.

JavaScript

<script>
    function requestPay() {
      IMP.request_pay({ 
          pg: "kcp",
          pay_method: "card",
          merchant_uid: "ORD20180131-0000011",   //주문번호
          name: "노르웨이 회전 의자",
          amount: 64900,                         // 숫자타입
          buyer_email: "[e-mail]",
          buyer_name: "홍길동",
          buyer_tel: "010-4242-4242",
          buyer_addr: "서울특별시 강남구 신사동",
          buyer_postcode: "01181",
          promotion_id : "프로모션 전용 고유번호",   // 프로모션 고유번호
          card:{                    // 프로모션 진행 카드사 모듈 바로 호출
              direct: {
                code: "367",        //프로모션 진행 카드사 코드
                quota: 3            //할부개월수
              }
          }
      }, function (rsp) { // callback
          if (rsp.success) {
              ...,
              // 결제 성공 시 로직,
              ...
          } else {
              ...,
              // 결제 실패 시 로직,
              ...
          }
      });
    }
  </script>

프로모션 결제 파라미터

버짓핸들러 서비스를 이용하기 위해서는 아래 파라미터를 반드시 설정하셔야 합니다. 해당 파라미터 누락시 프로모션 총 예산에서 차감되지 않습니다.

• promotion_id : 프로모션 정보획득 API 응답파라미터에서 확인 가능

주문번호(merchant_uid) 생성 시 유의사항

• 주문번호는 결제창 요청 시 항상 고유 값으로 채번 되어야 합니다.

• 결제 완료 이후 결제 위변조 대사 작업시 주문번호를 이용하여 검증이 필요하므로 주문번호는 가맹점 서버에서 고유하게(unique)채번하여 DB 상에 저장해주세요

주요 파라미터

promotion_id String

프로모션 고유번호

결제금액을 프로모션 예산금액에서 차감을 위해서는 해당 파라미터를 반드시 설정해야 합니다.

amount *integer

결제금액

프로모션 할인이 적용된 금액이 아닌 원금액을 설정합니다.

카드사 모듈 바로 호출

javascript

card: {
     direct: {
        code: "367",
        quota: 3
    }
}

파라미터 설명

• code : 카드사 금융결제원 표준 코드. 링크 참조 (string)

• quota : 할부 개월 수. 일시불일 시 0 으로 지정. (integer)

프로모션 인증결제 주의사항

• 프로모션 아이디만 입력시 : 프로모션 결제시 카드코드가 필수라고 표시되면 실패처리

• 프로모션 카드코드만 입력시 : 카드사 다이렉트 호출은 되나, 원금으로 결제

• 프로모션 아이디, 카드코드 둘다 누락시 : 일반kcp결제창이뜨고 원금으로 결제됨