송금 API
가맹점 서버에서 고객의 계좌로 현금을 이체(송금)하거나, 송금 가능한 계좌의 잔액을 조회합니다.
송금
가맹점의 모계좌에서 고객의 계좌로 송금을 요청합니다. 기본적으로 직계약 방식(directYn)을 지원하며, 재판매 방식은 별도 협의가 필요합니다. (영업담당자에게 문의해 주세요.)
API 정보
POST/v1/api/pay/rmt
Content-Type
application/json; charset=UTF-8테스트
https://tbnpay.settlebank.co.kr/v1/api/pay/rmt운영
https://npay.settlebank.co.kr/v1/api/pay/rmt요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*전문정보 코드
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*상점아이디
상점아이디
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점 주문번호 (한글 제외)
상점 주문번호 (한글 제외)
└mchtCustIdAN(100)영문+숫자, 최대 100byte
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)고객아이디고객아이디
└trdDtAN(8)영문+숫자, 최대 8byte*거래일자 (yyyyMMdd)
거래일자 (yyyyMMdd)
└trdTmAN(6)영문+숫자, 최대 6byte*거래시간 (HH24MISS)
거래시간 (HH24MISS)
└bankCdAN(3)영문+숫자, 최대 3byte*입금은행코드
입금은행코드
└custAcntNoAN(15)영문+숫자, 최대 15byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)입금은행 계좌번호 (하이픈 제외)입금은행 계좌번호 (하이픈 제외)
└custAcntSumryAN(14)영문+숫자, 최대 14byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)입금통장 인자내용 (전각문자 7자)입금통장 인자내용 (전각문자 7자)
└remitterNmAN(14)영문+숫자, 최대 14byte
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)송금인 실명 (국민은행 송금 시 필수, 전각문자 7자)송금인 실명 (국민은행 송금 시 필수, 전각문자 7자)
└directYnA(1)영문, 최대 1byte은행직계약여부 (Y: 직계약, N: 재판매)
은행직계약여부 (Y: 직계약, N: 재판매)
└macntBankCdAN(3)영문+숫자, 최대 3byte모계좌 은행코드 (직계약 시 필수)
모계좌 은행코드 (직계약 시 필수)
└macntNoAN(15)영문+숫자, 최대 15byte
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)모계좌 입금계좌번호 (직계약 시 필수)모계좌 입금계좌번호 (직계약 시 필수)
└macntSumryAN(12)영문+숫자, 최대 12byte
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)모계좌 통장 인자내용 (직계약 시 필수, 전각 6자)모계좌 통장 인자내용 (직계약 시 필수, 전각 6자)
└scrtCardValAN(6)영문+숫자, 최대 6byte
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)안전코드번호 (SC은행 직계약 시)안전코드번호 (SC은행 직계약 시)
└firmPktNoN(6)숫자, 최대 6byte펌뱅킹 전문번호
펌뱅킹 전문번호
└macntPwdAN(4)영문+숫자, 최대 4byte
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)모계좌 비밀번호 (새마을금고 등 필수)모계좌 비밀번호 (새마을금고 등 필수)
└trdAmtN(13)숫자, 최대 13byte*송금금액 (최대 10억원)
송금금액 (최대 10억원)
└custIpAN(15)영문+숫자, 최대 15byte고객 IP 주소
고객 IP 주소
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA-256 해쉬값(실시간 생성)SHA-256 해쉬값
NOTE
해쉬 생성 조합
mchtId + mchtTrdNo + trdDt + trdTm + bankCd + custAcntNo + trdAmt(평문) + hashKey
응답 파라미터
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드
0021거래상태코드
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*거절코드
0000거절코드
└outRsltMsgAN(300)영문+숫자, 최대 300byte*결과메시지
정상처리되었습니다.결과메시지
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점 주문번호
OID20210830080000상점 주문번호
└trdNoAN(40)영문+숫자, 최대 40byte*거래번호
STFP_FIRM1233444365430698거래번호
└trdAmtN(13)숫자, 최대 13byte*송금금액
1000송금금액
└svcDivCdN(4)숫자, 최대 4byte*송금 시 사용된 서비스
1송금 시 사용된 서비스
1: 펌뱅킹
