오픈뱅킹 > 이체 서비스
> 출금이체 API
이용기관이 사용자 계좌에서 출금합니다.
> 테스트URL POST
▶ TEST URL      https://tapi.nestpay.co.kr/mcht/openbanking/v1/transfer/withdraw
> 헤더
컬럼명 컬럼타입 설명 필수여부 비고
paykey String 가맹점 등록 후 전달받은 payKey 필수 "pk_keyin"
uuid String 고유 키 값 필수 "1234"
> 요청데이터
컬럼명 컬럼타입 설명 필수여부 비고
fintechUseNum String 출금계좌 핀테크 이용번호 필수 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
tranAmt int 금액 필수 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
transHash String 금액 위변조 값 필수 SHA256(uuid + tranAmt) 암호화 후 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
dpsPrintContent String 입금 인자 내역 필수 잔액 충전
wdPrintContent String 출금 인자 내역 선택 오픈뱅킹 출금
trxId String 가맹점 거래아이디 필수 50자내 유니크키
> 응답데이터
컬럼명 컬럼타입 설명 필수여부 비고
api_tran_id String 거래 고유번호(API)
api_tran_dtm String 거래일시
rsp_code String 응답코드
rsp_message String 응답메세지
dps_bank_code_std String 입금기관 표준코드
dps_bank_code_sub String 입금기관 점별코드
dps_bank_name String 입금기관명
dps_account_num_masked String 입금계좌번호(출력용)
dps_print_content String 입금계좌 인자내역
dps_account_holder_name String 수취인 성명
bank_tran_id String 거래고유번호(참가기관)
bank_tran_date String 거래일자(참가기관)
bank_code_tran String 응답코드를 부여한 참가기관 표준코드
bank_rsp_code String 응답코드(참가기관)
bank_rsp_message String 응답메시지(참가기관)
fintech_use_num String 출금계좌핀테크이용번호
account_alias String 출금계좌별명
bank_code_std String 출금(개설)기관.표준코드
bank_code_sub String 출금(개설)기관.점별코드
bank_name String 출금(개설)기관명
savings_bank_name String 개별저축은행명
account_num_masked String 출금계좌번호(출력용)
print_content String 출금계좌인자내역
account_holder_name String 송금인성명
tran_amt String 거래금액
wd_limit_remain_amt String 출금한도잔여금액
> 입금이체 API
이용기관이 사용자 계좌에 송금합니다.
> 테스트URL POST
▶ URL      https://tapi.nestpay.co.kr/mcht/openbanking/v1/transfer/deposit/{type}
> Path variable
컬럼명 컬럼타입 설명 필수여부 비고
type String 입금 타입 필수 fintechUseNum | account
> 헤더
컬럼명 컬럼타입 설명 필수여부 비고
paykey String 가맹점 등록 후 전달받은 payKey 필수 "pk_keyin"
uuid String 고유 키 값 필수 "1234"
> 요청데이터
컬럼명 컬럼타입 설명 필수여부 비고
fintechUseNum String 입금계좌 핀테크 이용번호 필수(type:fintechUseNum) (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
reqClientFintechUseNum String 요청 고객 핀테크 이용번호 필수 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
account String 입금계좌 계좌번호 필수(type:account) (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
bankCode String 입금계좌 계좌번호 필수(type:account) 02
accountHolderName String 예금주명 필수(type:account) (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
tranAmt int 금액 필수 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
transHash String 금액 위변조 값 필수 SHA256(uuid + tranAmt) 암호화 후 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
dpsPrintContent String 입금 인자 내역 필수 잔액 충전
wdPrintContent String 출금 인자 내역 필수 오픈뱅킹 출금
trxId String 가맹점 거래아이디 필수 50자내 유니크키
> 응답데이터
컬럼명 컬럼타입 설명 필수여부 비고
api_tran_id String 거래 고유번호(API)
api_tran_dtm String 거래일시
rsp_code String 응답코드
rsp_message String 응답메세지
wd_bank_code_std String 출금기관 표준코드
wd_bank_code_sub String 출금기관 점별코드
wd_bank_name String 출금기관명
wd_account_num_masked String 출금계좌번호(출력용)
wd_print_content String 출금계좌 인자내역
wd_account_holder_name String 송금인 성명
res_cnt String 입금건수
res_list String 입금목록 fintechUseNum tran_no : 거래순번
bank_tran_id : 거래고유번호(참가기관)
bank_tran_date : 거래일자(참가기관)
bank_code_tran : 응답코드를 부여한 참가기관.표준코드
bank_rsp_code : 응답코드(참가기관)
bank_rsp_message : 응답메시지(참가기관)
fintech_use_num : 핀테크이용번호
account_alias : 계좌별명(Alias)
bank_code_std : 입금(개설)기관.표준코드
bank_code_sub : 입금(개설)기관.점별코드
bank_name : 입금(개설)기관명
savings_bank_name : 개별저축은행명
account_num_masked : 입금계좌번호(출력용)
print_content : 입금계좌인자내역
account_holder_name : 수취인성명
tran_amt : 거래금액
cms_num : CMS 번호
res_list String 입금목록 account tran_no : 거래순번
bank_tran_id : 거래고유번호(참가은행)
bank_tran_date : 거래일자(참가은행)
bank_code_tran : 응답코드를 부여한 참가은행.표준코드
bank_rsp_code : 응답코드(참가은행)
bank_rsp_message : 응답메시지(참가은행)
bank_code_std : 입금(개설)기관.표준코드
bank_code_sub : 입금(개설)기관.점별코드
bank_name : 입금(개설)기관명
savings_bank_name : 개별저축은행명
account_num : 입금계좌번호
account_seq : 회차번호
account_num_masked : 입금계좌번호(출력용)
print_content : 입금계좌인자내역
account_holder_name : 수취인성명
tran_amt : 거래금액
cms_num : CMS 번호
> 송금이체 API
사용자가 사용자 계좌에 송금합니다.
> 테스트URL POST
▶ URL      https://tapi.nestpay.co.kr/mcht/openbanking/v1/transfer/send/{type}
> Path variable
컬럼명 컬럼타입 설명 필수여부 비고
type String 송금 입금 타입 필수 fintechUseNum | account
> 헤더
컬럼명 컬럼타입 설명 필수여부 비고
paykey String 가맹점 등록 후 전달받은 payKey 필수 "pk_keyin"
uuid String 고유 키 값 필수 "1234"
> 요청데이터
컬럼명 컬럼타입 설명 필수여부 비고
fintechUseNum String 입금계좌 핀테크 이용번호 필수(type:fintechUseNum) (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
reqClientFintechUseNum String 출금계좌 핀테크 이용번호 필수 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
account String 입금계좌 계좌번호 필수(type:account) (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
bankCode String 입금계좌 계좌번호 필수(type:account) 02
accountHolderName String 예금주명 필수(type:account) (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
tranAmt int 금액 필수 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
transHash String 금액 위변조 값 필수 SHA256(uuid + tranAmt) 암호화 후 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
dpsPrintContent String 입금 인자 내역 필수 잔액 충전
wdPrintContent String 출금 인자 내역 필수 오픈뱅킹 출금
trxId String 가맹점 거래아이디 필수 50자내 유니크키
recvTrxId String 송금전 송금입금할 계좌 수취조회 성공 trxId 필수 50자내 유니크키
> 응답데이터
컬럼명 컬럼타입 설명 필수여부 비고
amount String 거래금액
wdBankCode String 출금은행코드
wdBankName String 출금은행이름
wdAccountNumMasked String 출금계좌번호(masking)
wdPrintContent String 출금인자내역
wdAccountHolderName String 출금계좌 예금주
dpsBankCode String 입금은행코드
dpsBankName String 입금은행이름
dpsAccountNumMasked String 입금계좌번호(masking)
dpsPrintContent String 입금인자내역
dpsAccountHolderName String 입금계좌 예금주
> 수취조회 API
이용기관이 입금이체 요청 전 수취계좌의 입금가능여부 및 수취인성명을 사전에 조회합니다.
> 테스트URL POST
▶ TEST URL      https://tapi.nestpay.co.kr/mcht/openbanking/v1/transfer/inquiry/receive
> 헤더
컬럼명 컬럼타입 설명 필수여부 비고
paykey String 가맹점 등록 후 전달받은 payKey 필수 "pk_keyin"
uuid String 고유 키 값 필수 "1234"
> 요청데이터
컬럼명 컬럼타입 설명 필수여부 비고
fintechUseNum | accountNum String 출금계좌 핀테크 이용번호 2개중 1개 필수 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
bankCodeStd String 은행코드 필수(accountNum) 02
accountSeq String 회차번호 필수(accountNum) 001(3자리 숫자)
printContent String 입금 인자 내역 필수 잔액 충전
tranAmt String 금액 필수 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
transHash String 금액 위변조 값 필수 SHA256(uuid + tranAmt) 암호화 후 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
reqClientName String 요청고객성명 필수 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
reqClientFintechUseNum String 요청고객 핀테크번호 필수 (AES/CBC/PKCS5Padding + Base64 Encoding) 적용값 세팅
trxId String 가맹점 거래아이디 필수 50자내 유니크키
> 응답데이터
컬럼명 컬럼타입 설명 필수여부 비고
api_tran_id String 거래 고유번호(API)
api_tran_dtm String 거래일시
rsp_code String 응답코드
rsp_message String 응답메세지
bank_code_std String 입금기관 표준코드
bank_code_sub String 입금기관 점별코드
bank_name String 입금기관명
savings_bank_name String 개별저축은행명
account_num String 입금계좌번호
account_seq String 회차번호
account_num_masked String 입금계좌번호(출력용)
print_content String 입금계좌 인자내역
account_holder_name String 수취인 성명
bank_tran_id String 거래고유번호(참가기관)
bank_tran_date String 거래일자(참가기관)
bank_code_tran String 응답코드를 부여한 참가기관 표준코드
bank_rsp_code String 응답코드(참가기관)
bank_rsp_message String 응답메시지(참가기관)
wd_bank_code_std String 출금(개설)기관.표준코드
wd_bank_name String 출금(개설)기관명
wd_account_num String 출금계좌번호
tran_amt String 거래금액
cms_num String CMS번호
> 이체결과조회(가맹점용) API
가맹점이 출금이체 혹은 입금이체 후 이체결과를 다시 확인합니다.
이체 시 비정상적인 응답코드를 받았을 경우나 응답을 받지 못했을 경우 등 이체결과 확인이 필요한 경우 사용하는 용도입니다.
이체응답 또는 이체결과조회응답이 비정상적인 경우 이체결과조회를 수행하지 않고 이체를 재시도 할 경우 이중 이체가 될 수 있으니 반드시 이체결과를 확인하셔야 합니다.
> 테스트URL GET
▶ TEST URL      https://tapi.nestpay.co.kr/mcht/openbanking/v1/transfer/result/{trxId}/{type}
> 헤더
컬럼명 컬럼타입 설명 필수여부 비고
paykey String 가맹점 등록 후 전달받은 payKey 필수 "pk_keyin"
> Path variable
컬럼명 컬럼타입 설명 필수여부 비고
trxId String 가맹점 거래아이디 필수 이체시 세팅했던 trxId
type String 이체 타입 필수 00:출금이체,01:입금이체,02:송금이체
End of document