연동방법
•
설명
바로계좌결제 결제창 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 | 주문자성명 | 주문자 성명 | Y | "홍길동" |
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 |
sample 소스
encodeURIComponent을 통해 요청 값을 인코딩 후, get 방식으로 바로계좌결제창 호출합니다.
결제창 도메인
•
개발 : https://barotongjangdev.hyphen.im
•
운영 : https://barotongjang.hyphen.im
const applyData = {
mrstSno: 1,
mrstNm: ‘테스트 상점’,
prdNm: ‘테스트 상품’,
uscoSno: 1
ordNo: ‘s20230807143435’,
rqsAmt: 10000,
mbtlNo: ‘’,
name: ‘테스트’,
redirectUrl: ‘https://redirect.co.kr’,
cancelUrl: ‘https://redirect.co.kr/cancel’,
returnUrl: ‘’,
disgnCd: '#5E0BD9',
echA: ‘’,
signVl: ‘’,
}
window.open(`도메인 + /pay/login?data=${encodeURIComponent(JSON.stringify(applyData))}`, '_self')
JavaScript
복사
결제 흐름
1.
호출한 결제창 내에서 결제처리가 진행됩니다.
회원이 아닐 경우에는 바로계좌결제 창 내에서 회원 가입 절차가 진행되며, 회원 인 경우 바로 결제창으로 넘어갑니다.
신규회원 :
2.
결제가 완료된 후 오류 또는 결과 값이 지정된 URL 로 호출됩니다.