카드 인증결제(UI)
카드 인증결제는 UI방식으로 결제수단에 맞는 값을 입력후 창을 호출하시면 됩니다.
통지 URL을 넥스페이에 설정요청 바랍니다.
통지 URL을 넥스페이에 설정요청 바랍니다.
4. 카드 인증결제 과정
1. 넥스페이로 결제요청
2. 전송값 1차 검증 후 PG사로 결제요청 데이터 전송
전송값에 오류가 있을경우 PG사로 결제요청을 하지 않고 오류가 발생합니다.
3. PG사로 결제요청 데이터 전송
전송값에 이상이 있을경우 결제 진행이 되지 않고 오류가 발생합니다.
4. PG결제폼 제공
PG사의 결제창(스타일 변경불가)이 팝업됩니다.
5. 결제실행
결제정보를 PG사 서버로 전송하며, PG사에서는 각 카드사에 해당 정보를 전송하게 됩니다.
6. PG사 결제완료 데이터 전송
PG사로부터 넥스페이 서버로 결제완료 정보가 전송됩니다.
7. 넥스페이 결제완료 데이터 전송
결제완료 정보를 클라이언트로 전송합니다.
2. 전송값 1차 검증 후 PG사로 결제요청 데이터 전송
전송값에 오류가 있을경우 PG사로 결제요청을 하지 않고 오류가 발생합니다.
3. PG사로 결제요청 데이터 전송
전송값에 이상이 있을경우 결제 진행이 되지 않고 오류가 발생합니다.
4. PG결제폼 제공
PG사의 결제창(스타일 변경불가)이 팝업됩니다.
5. 결제실행
결제정보를 PG사 서버로 전송하며, PG사에서는 각 카드사에 해당 정보를 전송하게 됩니다.
6. PG사 결제완료 데이터 전송
PG사로부터 넥스페이 서버로 결제완료 정보가 전송됩니다.
7. 넥스페이 결제완료 데이터 전송
결제완료 정보를 클라이언트로 전송합니다.
API 연동 과정
결제연동 URL
개발서버 : http://develop.nex.magnexpay.com/nexpay/Link [POST]
운영서버 : https://nex-pay.co.kr/nexpay/Link [POST]
운영서버 : https://nex-pay.co.kr/nexpay/Link [POST]
4.1 결제 요청 전문
| 구분 | 항목명 | 길이 | 내용 | 비고 |
|---|---|---|---|---|
| 모든 결제수단 공통항목(필수) | ||||
| 필수 | USERID | 10 | 가맹점ID | 넥스페이 발급 아이디 |
| 필수 | PAYMETHOD | 10 | 결제수단 |
CARD = 카드인증결제 KAKAOPAY = 카카오페이 NAVERPAY = 네이버페이 BANK = 계좌이체 결제 VACCT = 가상계좌 결제 SAMSUNGPAY = 삼성페이 PAYCO = 페이코 |
| 필수 | TYPE | 1 | 결제방식 |
P=PC M=모바일 W=웹뷰 |
| 필수 | ORDERNO | 30 | 주문번호 | |
| 필수 | AMOUNT | 10 | 거래금액 | |
| 필수 | PRODUCTNAME | 30 | 상품명 | |
| 필수 | PRODUCTCODE | 10 | 상품코드 | |
| 모든 결제수단 공통항목(선택) | ||||
| 선택 | 30 | 고객 이메일 | ||
| 선택 | USERNAME | 30 | 고객명 | |
| 선택 | RESERVEDINDEX1 | 예약항목 | ||
| 선택 | RESERVEDSTRING | 예약스트링 | ||
| 선택 | RETURNURL | 결제 성공 후, 이동할 URL(새 창) | * 둘중 하나만 입력 | |
| 선택 | HOMEURL | 결제 성공 후, 이동할 URL(결제 창에서 이동) | ||
| 선택 | SET_LOGO | 결제 창 하단 상점로고 URL | ||
| 웹뷰 결제창 필수 항목(조건 필수) | ||||
| 조건 필수 |
CLOSEURL | 결제 창에서 취소 누를 시 이동할 URL | ||
| 조건 필수 |
FAILURL | 결제실패 후, 확인버튼 클릭 시 이동할 URL | ||
| 조건 필수 |
APPURL | 인증완료 후 돌아갈 앱의 URL |
* PAYMETHOD 조건별 필수 CARD=카드인증결제 BANK=계좌이체결제 |
|
| 신용카드 필수 항목(조건 필수) | ||||
| 조건 필수 |
TAXFREECD | 과세/비과세여부 | 00 = 과세 01 = 비과세 02 = 복합과세 |
|
| 조건 필수 |
TELNO2 | 비과세 대상금액 |
* TAXFREECD 조건별 필수 복합과세(02)인 경우만 전송 |
|
| 신용카드 선택 항목(조건 선택) | ||||
| 조건 선택 |
CPQUOTA | 2 | 최대 할부 개월 수 | 구분자":" ex)12개월 할부 00:02:03:04:05:06:07:08:09:10:11:12 |
| 계좌이체 선택 항목(조건 선택) | ||||
| 조건 선택 |
USERSSN | 6 | 생년월일 | YYMMDD |
| 조건 선택 |
CHECKSSNYN | 1 | USERSSN 사용여부 | Y/N 사용(Y) > 계좌이체 결제자와 명의자(USERSSN)가 동일한 경우만 결제가능 |
| 가상계좌 선택 항목(조건 선택) | ||||
| 조건 선택 |
DEPOSITENDDATE | 14 | 입금만료일 | YYYYMMDD24MISS 미 입력시 기본 7일 |
| 조건 선택 |
RECEIVERNAME | 30 | 수취인명 | 지정하지 않으면 기본 '넥스페이' |
| 조건 선택 |
CASHRECEIPTFLAG | 1 | 현금영수증 발행여부 | 1 = 발행 2 = 미발행 |
| 조건 선택 |
VTAXFREECD | 과세여부 | 00 = 과세 01 = 비과세 02 = 복합과세 |
|
결제연동 요청 예제 (html) [코드 다운로드]
4.2 결제성공 응답 전문
| 구분 | 항목명 | 길이 | 내용 | 비고 |
|---|---|---|---|---|
| 카드인증결제(CARD) 응답전문 | ||||
| 필수 | PAYMETHOD | 10 | 결제수단 | |
| 필수 | DAOUTRX | 30 | 거래번호 | |
| 필수 | ORDERNO | 30 | 주문번호 | |
| 필수 | AUTHNO | 30 | 승인번호 | |
| 필수 | AMOUNT | 10 | 결제금액 | |
| 필수 | SETTDATE | 14 | 거래일시 | YYYYMMDD24MISS |
| 필수 | 이메일 | |||
| 필수 | USERID | 10 | 가맹점ID | |
| 필수 | USERNAME | 30 | 고객명 | |
| 필수 | PRODUCTCODE | 10 | 상품코드 | |
| 필수 | PRODUCTNAME | 30 | 상품명 | |
| 필수 | CARDCODE | 4 | 카드사 코드 | |
| 필수 | CARDNAME | 10 | 카드사명 | |
| 필수 | CARDNO | 16 | 카드번호 | 마스킹 처리 |
| 필수 | NOINTFLAG | 1 | 무이자여부 | Y/N |
| 필수 | RESERVEDINDEX1 | 20 | 예약어 | |
| 필수 | RESERVEDSTRING | 500 | 예약어 | |
| 필수 | INSTALL | 2 | 할부개월수 | |
| 카카오페이(KAKAOPAY) 응답전문 | ||||
| 필수 | PAYMETHOD | 10 | 결제수단 | |
| 필수 | PAYMENTTYPE | 10 | 결제구분 | CARD MONEY |
| 필수 | DAOUTRX | 30 | 거래번호 | |
| 필수 | ORDERNO | 30 | 주문번호 | |
| 필수 | AUTHNO | 30 | 승인번호 | * 카카오페이 없음 |
| 필수 | AMOUNT | 10 | 결제금액 | |
| 필수 | SETTLEDATE | 14 | 거래일시 | YYYYMMDD24MISS |
| 필수 | USERID | 10 | 가맹점ID | |
| 필수 | USERNAME | 30 | 고객명 | |
| 필수 | PRODUCTCODE | 10 | 상품코드 | |
| 필수 | PRODUCTNAME | 30 | 상품명 | |
| 필수 | CARDCODE | 4 | 카드사 코드 | |
| 필수 | CARDNAME | 10 | 카드사명 | |
| 필수 | RESERVEDINDEX1 | 20 | 예약어 | |
| 필수 | RESERVEDSTRING | 500 | 예약어 | |
| 필수 | ALLOTMON | 2 | 할부개월수 | |
| 필수 | NOINTFLAG | 1 | 무이자여부 | Y/N |
| 네이버페이(NAVERPAY) 응답전문 | ||||
| 필수 | PAYMETHOD | 10 | 결제수단 | |
| 필수 | PAYMENTTYPE | 10 | 결제구분 | CARD MONEY |
| 필수 | DAOUTRX | 30 | 거래번호 | |
| 필수 | ORDERNO | 30 | 주문번호 | |
| 필수 | AMOUNT | 10 | 결제금액 | |
| 필수 | SETTDATE | 14 | 거래일시 | YYYYMMDD24MISS |
| 필수 | USERID | 10 | 가맹점ID | |
| 필수 | USERNAME | 30 | 고객명 | |
| 필수 | PRODUCTCODE | 10 | 상품코드 | |
| 필수 | PRODUCTNAME | 30 | 상품명 | |
| 필수 | RESERVEDINDEX1 | 20 | 예약어 | |
| 필수 | RESERVEDSTRING | 500 | 예약어 | |
| 조건 필수 |
AUTHNO | 30 | 승인번호 | * PAYMENTTYPE = CARD 일 경우 리턴 |
| 조건 필수 |
ALLOTMON | 2 | 할부개월수 | |
| 조건 필수 |
NOINTFLAG | 1 | 무이자여부 | |
| 조건 필수 |
CARDCODE | 4 | 카드사 코드 | |
| 조건 필수 |
CARDNAME | 10 | 카드사명 | |
| 조건 필수 |
CARDNO | 16 | 카드번호 | |
| 조건 필수 |
CASHRECAUTHNO | 30 | 현금영수증 승인번호 | * PAYMENTTYPE = POINT 일 경우 리턴 |
| 계좌이체(BANK) 응답전문 | ||||
| 필수 | PAYMETHOD | 10 | 결제수단 | |
| 필수 | DAOUTRX | 30 | 거래번호 | |
| 필수 | ORDERNO | 30 | 주문번호 | |
| 필수 | AMOUNT | 10 | 결제금액 | |
| 필수 | SETTDATE | 14 | 거래일시 | YYYYMMDD24MISS |
| 필수 | 이메일 | |||
| 필수 | USERID | 10 | 가맹점ID | |
| 필수 | USERNAME | 30 | 고객명 | |
| 필수 | PRODUCTCODE | 10 | 상품코드 | |
| 필수 | BANKNAME | 20 | 은행명 | |
| 필수 | CASHRECAUTHNO | 30 | 현금영수증 승인번호 | |
| 필수 | PRODUCTNAME | 30 | 상품명 | |
| 필수 | RESERVEDINDEX1 | 20 | 예약어 | |
| 필수 | RESERVEDSTRING | 500 | 예약어 | |