연동방법
•
설명
바로계좌결제 결제창 UI를 아래에 명시 된 파라미터를 포함하여 호출합니다.
해당 결제창에서 오픈뱅킹 출금이체를 위해 휴대폰본인인증, 예금주조회, 1원인증, ARS 인증을 통해 회원가입을 하며, 결제정보등록을 한 후 그 결과를 redirect로 응답 받습니다.
•
요청 데이터
parameter | parameter명 | 설명 | 필수 | 비고 |
mrstSno | 상점일련번호 | 상점일련번호 | Y | 상점번호 |
mrstNm | 상점명 | 상점명 | Y | "테스트상점" |
prdNm | 상품명 | 상품명 | Y | "테스트상품" |
uscoSno | 이용사일련번호 | 이용사일련번호 | Y | 1 고정 |
ordNo | 주문번호 | 임의의 고유 주문번호 | Y | "s20230807143435" |
rqsAmt | 요청금액 | 상품 가격 | Y | 10000 |
mbtlNo | 휴대폰번호 | 주문자 휴대폰번호 | N | 01012345678, “-” 제거 |
name | 주문자성명 | 주문자 성명 | N | "홍길동", 이름 미 입력 시 검증 안함 |
returnUrl | 결과 URL | 결제 완료 후, 이동할 페이지 URL | Y | "https://hyphen.im/return" |
cancelUrl | 취소 URL | 결제 진행 중 취소 시 이동할 페이지 URL | Y | "https://hyphen.im/cancel" |
signVl | 서명값 | 거래 검증을 위한 서명값 | Y | |
disgnCd | 디자인색상코드 | 디자인색상코드 | N | "#5E0BD9" |
echA | 추가 파라미터 | 추가 파라미터 | N | 가맹점에서 다시 받기 위한 값 |
svAmt | 공급가액 | 공급가액 | N | 현금영수증 사용 시 필수 |
vatAmt | 부가세액 | 부가세액 | N | 현금영수증 사용 시 필수 |
tfAmt | 면세금액 | 면세금액 | N | 현금영수증 사용 시 필수 |
tpAmt | 봉사료 | 봉사료 | N | 현금영수증 사용 시 필수 |
•
응답데이터
parameter | parameter명 | 설명 | 필수 | 비고 |
mbrSno | 회원일련번호 | 회원일련번호 | Y | |
mrstSno | 상점일련번호 | 상점일련번호 | Y | 1 |
trAprvNo | 거래승인번호 | 거래 승인번호 | Y | "20230807010000000020" |
trDt | 거래일자 | 결제 승인 일자 | Y | "20230807" |
trTm | 거래시각 | 결제 승인 시각 | Y | "152411" |
ordNo | 주문번호 | 임의의 고유 주문번호 | Y | "s20230807143435" |
stlmWyDcmtNo | 결제수단식별번호 | 계좌 등록 시 일련번호 | Y | “1” |
rqsAmt | 가격 | 상품 가격 | Y | 10000 |
btPcsAmt | 계좌처리금액 | 계좌 처리 금액 | Y | 10000 |
bnkCd | 은행코드 | 은행코드 | Y | "090" |
bnkNm | 은행명 | 은행명 | Y | “카카오” |
acno | 계좌번호 | 계좌번호 | Y | "1314" |
rsltCd | 결과응답코드 | 결과응답코드 | Y | "HCO000" |
rsltMesg | 결과응답메세지 | 결과응답메세지 | Y | "정상으로 처리되었어요" |
dnxDscd | 소득공제구분코드 | 소득공제구분코드 | N | 0 : 핸드폰번호, 1 : 사업자번호 |
dnxVl | 소득공제요청값 | 소득공제요청값 | N | "01012345678" |
echA | 추가 파라미터 | 추가 파라미터 | N | |
cshRcptIsnYn | 현금영수증발급여부 | 현금영수증발급여부 | Y | |
cshRcptTrUnqNo | 현금영수증거래고유번호 | 현금영수증거래고유번호 | N | |
cshRcptAprvNo | 현금영수증승인번호 | 현금영수증승인번호 | N | |
cshRcptMsg1 | 현금영수증메세지1 | 현금영수증메세지1 | N | |
cshRcptMsg2 | 현금영수증메세지2 | 현금영수증메세지2 | N | |
svAmt | 공급가액 | 공급가액 | Y | 현금영수증 사용 시 필수 |
vatAmt | 부가세액 | 부가세액 | Y | 현금영수증 사용 시 필수 |
tfAmt | 면세금액 | 면세금액 | Y | 현금영수증 사용 시 필수 |
tpAmt | 봉사료 | 봉사료 | Y | 현금영수증 사용 시 필수 |
sample 소스
encodeURIComponent을 통해 요청 값을 인코딩 후, get 방식으로 바로계좌결제창 호출합니다.
결제창 도메인
•
개발 : https://barotongjangdev.hyphen.im
•
운영 : https://barotongjang.hyphen.im
const formObj = {
mrstSno: 1, // 상점일련번호 (필수)
ordNo: “client 주문번호” // 주문번호(필수)
uscoSno: 1, // 상점 아이디 (필수)
returnUrl: 'client return URL', // 리다이렉트 URL (필수)
cancelUrl: `client cancel URL`, // 취소 URL (필수)
mbtlNo: "", // 휴대폰번호 (선택)
disgnCd: "#5E0BD9", // 디자인 색상코드, hex코드만 가능 (선택)
mrstNm: "테스트상점", // 상점명
prdNm: "테스트상품", // 상품명 (필수)
rqsAmt: 10000, // 가격 (필수)
echA: "", // 추가 파라미터 = 가맹점에서 다시 받기 위한 값 (선택)
ci: "", // 고객 CI (선택)
svAmt: Math.round(10000 / 1.1), // 공급가액 = 현금영수증 사용시 필수
vatAmt: 10000 - Math.round(10000 / 1.1), // 부가세액 = 현금영수증 사용시 필수
tfAmt: 0, // 면세금액 = 현금영수증 사용시 필수
tpAmt: 0, // 봉사료 = 현금영수증 사용시 필수
name: "홍길동",
signVl: "", // sign API의 응답값 추가(필수)
}
const queryStringData = encodeURIComponent(JSON.stringify(formObj));
const openUrl = `/pay/login?data=${queryStringData}`;
window.open(openUrl, "_blank", featureWindow);
JavaScript
복사
결제 흐름
1.
호출한 결제창 내에서 결제처리가 진행됩니다.
회원이 아닐 경우에는 바로계좌결제 창 내에서 회원 가입 절차가 진행되며, 회원 인 경우 바로 결제창으로 넘어갑니다.
신규회원 :
2.
결제가 완료된 후 오류 또는 결과 값이 지정된 URL 로 호출됩니다.