연동 개요
방식Open Banking API + REST
Base URLhttps://api.webcash.co.kr/banking/v1
메시지 규격ISO 20022 (국제 금융 표준)
응답 포맷JSON / XML (선택)
인증 방식
방식OAuth 2.0 (금융결제원 오픈뱅킹)
Grant TypeAuthorization Code / Client Credentials
서명HMAC-SHA256 요청 서명 필수
토큰 만료액세스 30분 / 리프레시 90일
주요 API
POST/chat자연어 뱅킹 질의
GET/accounts보유 계좌 목록
GET/accounts/{id}/balance잔액 조회
GET/transactions거래 내역 조회
POST/transfers이체 실행
POST/fx/quote외환 환율 조회 및 거래
연동 예시
# 자연어 뱅킹 질의
curl -X POST \
https://api.webcash.co.kr/banking/v1/chat \
-H "Authorization: Bearer {token}" \
-H "X-Signature: {hmac}" \
-d '{"message":"신한은행 계좌로
100만원 이체해줘",
"customer_id":"CUS_001"}'
# 응답
{
"intent": "transfer",
"confirm_required": true,
"summary": "신한은행 ****-1234 → ₩1,000,000"
}
지원 환경 / SDK
Java SDK
Python SDK
금융결제원 오픈뱅킹
ISO 20022
Swift MT
보안 / 규격
전송 암호화TLS 1.3
요청 서명HMAC-SHA256
이상 거래 탐지FDS 실시간 연동
준수 규격전자금융거래법, 오픈뱅킹 보안 가이드