오픈뱅킹 서비스해지 API
고객의 오픈뱅킹 서비스 이용을 해지합니다.
해당 API를 호출하면 고객의 오픈뱅킹 서비스 이용이 해지되며, 등록된 모든 계좌 정보가 삭제됩니다.
API 정보
POST/v2/api/member/withdraw
Content-Type
application/json테스트
https://tbnpay.settlebank.co.kr/v2/api/member/withdraw운영
https://npay.settlebank.co.kr/v2/api/member/withdraw요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*전문정보 코드
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*헥토파이낸셜에서 부여하는 고유 상점아이디
헥토파이낸셜에서 부여하는 고유 상점아이디
└mchtCustIdAN(100)영문+숫자, 최대 100byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)상점에서 보내주는 고유 고객아이디 혹은 Unique 한 Key상점에서 보내주는 고유 고객아이디 혹은 Unique 한 Key
└trdDtAN(8)영문+숫자, 최대 8byte*거래일자
거래일자
*YYYYMMDD
└trdTmAN(6)영문+숫자, 최대 6byte*거래시간
거래시간
*HH24MISS
└custIpAN(15)영문+숫자, 최대 15byte고객 IP 주소
고객 IP 주소
*가맹점 서버의 IP가 아닌 고객 기기의 IP 주소
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA256 방식으로 생성한 해쉬값(실시간 생성)SHA256 방식으로 생성한 해쉬값
*상점아이디 + 고객아이디(평문) + 거래일자 + 거래시간 + 인증키
요청 전문 해쉬 코드
| 항목 | 조합 필드 |
|---|---|
| pktHash 값 | 상점아이디 + 고객아이디(평문) + 거래일자 + 거래시간 + 인증키 |
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드 (성공/실패)
거래상태코드 (성공/실패)
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*거절코드
거절코드
*거절코드 테이블 참조
└outRsltMsgAN(300)영문+숫자, 최대 300byte*결과메시지
정상처리되었습니다.결과메시지
*오류가 발생시 오류에 대한 메시지 전달
└mchtCustIdAN(100)영문+숫자, 최대 100byte*상점 고객아이디
kimhecto상점 고객아이디
*해지된 고객 아이디
└wdDtAN(8)영문+숫자, 최대 8byte*해지일자
20230330해지일자
*YYYYMMDD
요청 예시
{
"hdInfo": "SPAY_MW0W_1.0",
"mchtId": "midtest",
"mchtCustId": "AES암호화된고객아이디",
"trdDt": "20230330",
"trdTm": "095512",
"custIp": "127.0.0.1",
"pktHash": "해시값"
}
응답 예시
{
"outStatCd": "0021",
"outRsltCd": "0000",
"outRsltMsg": "정상처리되었습니다.",
"mchtCustId": "kimhecto",
"wdDt": "20230330"
}
