개발자센터
V1
V2
파트너 정산 릴리즈 노트 기술 블로그

내통장결제

핵토파이낸셜에서 제공하는 오픈뱅킹 기반 계좌간편결제 연동 방법을 안내합니다.

1. 내통장결제 채널 설정하기

결제대행사 채널 설정하기 페이지의 내용을 참고하여 채널 설정을 진행합니다.

2.결제 요청하기

JavaScript SDK IMP.request_pay(param, callback)을 호출하여 내통장 결제 결제창을 호출할 수 있습니다. 결제결과는 PC의 경우 IMP.request_pay(param, callback) 호출 후 callback 으로 수신되며, 모바일의 경우 m_redirect_url 로 리디렉션됩니다.

Javascript SDK
IMP.request_pay( { // param pg: "settle_acc.MID", // 발급받은 고객사아이디 pay_method: "trans", merchant_uid: "ORD20180131-0000011", name: "노르웨이 회전 의자", buyer_email: "gildong@gmail.com", buyer_name: "홍길동", buyer_tel: "010-1234-5678", buyer_addr: "서울특별시 강남구 삼성동", m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}", amount: 1000, bypass: { settle: { addDeductionYn: "N", // 추가공제구분 (대중교통:Y, 도서,공연비:C, 추가공제없음:N) criPsblYn: "N", // 현금영수증 발행가능 여부 ( Y or N or ""빈문자열은 Y로인식) custCi: "<회원 연계정보(Connecting Information)>", // 고객사가 보유한 회원 CI를 설정하면 내통장 결제에 등록한 CI와 비교하여 동일인인지 자동검증되며 일치하지 않은 경우 결제가 중단됩니다. }, }, }, function (rsp) { // callback // 생략 }, );

주요 파라미터 설명

pg string

PG사 구분코드

settle_acc.MID 형태로 지정해야 합니다.

pay_method * string

결제수단 구분코드

trans만 사용 가능합니다.

merchant_uid * string

고객사 고유주문번호

매번 고유하게 채번되어야 합니다.

buyer_tel * string

구매자 연락처

필수 파라미터 입니다.

amount * integer

결제금액

bypass oneof object

PG사 결제창 호출 시 PG사로 그대로 bypass할 값들의 모음

custCi * string

주문자 CI

(2024.06월부터 필수파라미터로 변경되어 결제 요청시 필수로 입력해야합니다.)

고객사가 보유한 회원 CI를 설정하면 내통장 결제에 등록한 CI와 비교하여 동일인인지 자동검증되며

일치하지 않은 경우 결제가 중단됩니다.

addDeductionYn string

추가공제구분

대중교통: Y, 도서 및 공연비: C, 추가공제없음: N

계약 후 사용 가능합니다.

criPsblYn string

현금영수증 발행가능 여부

Y or N or "", 빈문자열은 Y로 인식

  1. 내통장결제는 팝업 형태로 제공됩니다.
  2. 매출전표가 제공되지 않습니다.
  3. 선불충전금 ( ex: 카카오페이, 네이버페이 충전금)으로만 결제하는 경우 계좌정보(은행코드)가 제공되지 않습니다.