헥토파이낸셜 개발자센터

송금 API

가맹점 서버에서 헥토파이낸셜 서버로 송금을 요청합니다.

API 정보

POST/v2/api/pay/rmt
Content-Typeapplication/json
테스트https://tbnpay.settlebank.co.kr/v2/api/pay/rmt
운영https://npay.settlebank.co.kr/v2/api/pay/rmt

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*
헥토파이낸셜에서 부여하는 고유 상점아이디
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*
상점 주문번호
*한글제외
└mchtCustIdAN(100)영문+숫자, 최대 100byteAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
상점에서 보내주는 고유 고객아이디 혹은 Unique 한 Key
└trdDtAN(8)영문+숫자, 최대 8byte*
거래일자
*yyyyMMdd
└trdTmAN(6)영문+숫자, 최대 6byte*
거래시간
*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자)
└remitterNmAN(14)영문+숫자, 최대 14byteAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
송금인 실명 (국민은행 송금 시 필수, 전각문자 7자)
└directYnA(1)영문, 최대 1byte
은행직계약여부
N: 재판매 (기본값) Y: 직계약
└macntBankCdN(3)숫자, 최대 3byte
모계좌 은행코드
*금융기관코드 테이블 참고(은행직계약시). directYn Y 직계약 경우 필수
└macntNoAN(15)영문+숫자, 최대 15byteAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
모계좌 입금계좌번호
*모계좌 계좌번호 "-" 제외(은행 직계약시). directYn Y (직계약) 인 경우 필수
└macntSumryAN(6)영문+숫자, 최대 6byteAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
모계좌 통장인자내용
*모계좌 통장에 찍힐 인자내용(은행직계약시). 전각문자 사용 (6자). directYn Y (직계약) 인 경우 필수
└scrtCardValAN(6)영문+숫자, 최대 6byteAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
안전코드번호
*직계약 SC 은행 산출된 안전카드 번호
└firmPktNoN(6)숫자, 최대 6byte
펌뱅킹전문번호
└macntPwdAN(4)영문+숫자, 최대 4byteAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
모계좌 비밀번호
*은행별 계약에 따른 선택 입력사항 (새마을금고 필수)
└trdAmtN(13)숫자, 최대 13byte*
거래금액
*송금할 금액(거래금액). 최대 10억원
└mchtCustBankCdN(3)숫자, 최대 3byte
고객계좌은행코드
*송금을 요청하는 고객의 은행코드. 오픈뱅킹 사용시 필수. 금융기관코드 테이블 참조
└custIpAN(15)영문+숫자, 최대 15byte
고객 IP주소
*가맹점 서버의 IP가 아닌 고객 기기의 IP주소
└pktHashAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA256 방식으로 생성한 해쉬값
*상점아이디 + 주문번호 + 거래일자 + 거래시간 + 입금은행코드 + 입금계좌번호(평문) + 거래금액 + 인증키

요청 전문 해쉬 코드

항목조합 필드
pktHash 값상점아이디 + 주문번호 + 거래일자 + 거래시간 + 입금은행코드 + 입금계좌번호(평문) + 거래금액 + 인증키

응답 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└outStatCdAN(4)영문+숫자, 최대 4byte*
거래상태코드 (성공/실패)
0021: 성공 0031: 실패
└outRsltCdAN(4)영문+숫자, 최대 4byte*
거절코드
*거절코드 테이블 참조. ST08: 이미 등록된 계좌일 경우 등록된 계좌 정보 전달
└outRsltMsgAN(300)영문+숫자, 최대 300byte*정상처리되었습니다.
결과메시지
*오류가 발생시 오류에 대한 메시지 전달
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*OID20210830080000
상점 주문번호
*한글제외
└trdNoAN(40)영문+숫자, 최대 40byte*STFP_FIRM1233444365430698
헥토파이낸셜 거래번호
└trdAmtN(13)숫자, 최대 13byte*1000
송금금액
└svcDivCdN(4)숫자, 최대 4byte*
송금시 사용된 서비스
1: 펌뱅킹 2: 오픈뱅킹

요청 예시

{
  "hdInfo": "SPAY_AR0W_1.0",
  "mchtId": "midtest",
  "mchtTrdNo": "OID2021083012345",
  "mchtCustId": "AES암호화된고객아이디",
  "trdDt": "20191231",
  "trdTm": "120000",
  "bankCd": "004",
  "custAcntNo": "AES암호화된계좌번호",
  "custAcntSumry": "AES암호화된통장인자",
  "directYn": "N",
  "trdAmt": "1000",
  "custIp": "127.0.0.1",
  "pktHash": "해시값"
}

응답 예시

{
  "outStatCd": "0021",
  "outRsltCd": "0000",
  "outRsltMsg": "정상처리되었습니다.",
  "mchtTrdNo": "OID20210830080000",
  "trdNo": "STFP_FIRM1233444365430698",
  "trdAmt": "1000",
  "svcDivCd": "2"
}
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?