계좌성명조회

계좌성명조회 요청
post

해당 계좌의 예금주를 확인합니다.

https://papi.udpay.co.kr/api/v1/account/checkAccount

  • pApiToken

    STRING 필수

    연동토큰

    UDPAY 부가서비스 연동토큰

  • code

    STRING

    은행 코드

    허용값 리스트
    002 산업은행
    003 기업은행
    004 국민은행
    007 수협중앙회
    011 농협은행
    012 지역농축협
    020 우리은행
    023 SC은행
    027 한국씨티은행
    031 대구은행
    032 부산은행
    034 광주은행
    035 제주은행
    037 전북은행
    039 경남은행
    045 새마을금고연합회
    048 신협
    050 저축은행
    054 HSBC은행
    055 도이치은행
    057 제이피모간체이스은행
    060 BOA은행
    061 비엔피파리바은행
    062 중국공상은행
    064 산림조합
    067 중국건설은행
    071 우체국
    081 하나은행
    088 신한은행
    089 케이뱅크
    090 카카오뱅크
    209 유안타증권
    218 KB증권
    227 KTB투자증권
    238 미래에셋대우
    240 삼성증권
    243 한국투자증권
    247 NH투자증권
    261 교보증권
    262 하이투자증권
    263 현대차증권
    264 키움증권
    265 이베스트투자증권
    266 SK증권
    267 대신증권
    269 한화투자증권
    270 하나금융투자
    278 신한금융투자
    279 DB금융투자
    280 유진투자증권
    287 메리츠종합금융증권
    290 부국증권
    291 신영증권
    292 케이프투자증권
    294 펀드온라인코리아

  • accNum

    STRING

    계좌번호

  • state

    STRING 필수

    요청 결과

    true 성공, false 실패

  • message

    STRING

    메세지

    요청 결과 메세지

  • errorMessage

    STRING

    오류 메세지

    요청 결과에 대한 오류 메세지

  • errorType

    STRING

    오류 번호

    요청 결과에 대한 오류 번호

  • result

    OBJECT

    결과 데이터

    결과 데이터 정보

    • id

      STRING

      결과 데이터 ID

    • accNum

      STRING

      계좌번호

    • accName

      STRING

      성명

    • state

      STRING

      조회 상태

    • errMsg

      STRING

      오류 메세지

코드샘플
// https://mvnrepository.com/artifact/com.konghq/unirest-java/3.6.01

Map<String, Object> paramMap = new HashMap<> ();

paramMap.put ("code", "");	// 은행 코드
paramMap.put ("accNum", "");	// 계좌번호

HttpResponse response = Unirest.post("https://papi.udpay.co.kr/api/v1/account/checkAccount")
.header("accept", "application/json")
.header("Content-Type", "application/json")
.header("pApiToken", "") // 연동토큰
.body(paramMap)
.asJson();

// JSONObject obj = response.getBody().getObject().getJSONObject("objKey");
// String strVal = obj.getString ("strKey");
// JSONArray arr = response.getBody().getObject().getJsonArray("arrayKey");

계좌점유인증

계좌점유인증 요청
post

해당 계좌의 사용자가 유효한지 확인하기 위해서 입력한 계좌로 1원을 입금합니다.

https://papi.udpay.co.kr/api/v1/account/requestAccountAuth

  • pApiToken

    STRING 필수

    연동토큰

    UDPAY 부가서비스 연동토큰

  • code

    STRING 필수

    은행 코드

    허용값 리스트
    002 산업은행
    003 기업은행
    004 국민은행
    007 수협중앙회
    011 농협은행
    012 지역농축협
    020 우리은행
    023 SC은행
    027 한국씨티은행
    031 대구은행
    032 부산은행
    034 광주은행
    035 제주은행
    037 전북은행
    039 경남은행
    045 새마을금고연합회
    048 신협
    050 저축은행
    054 HSBC은행
    055 도이치은행
    057 제이피모간체이스은행
    060 BOA은행
    061 비엔피파리바은행
    062 중국공상은행
    064 산림조합
    067 중국건설은행
    071 우체국
    081 하나은행
    088 신한은행
    089 케이뱅크
    090 카카오뱅크
    209 유안타증권
    218 KB증권
    227 KTB투자증권
    238 미래에셋대우
    240 삼성증권
    243 한국투자증권
    247 NH투자증권
    261 교보증권
    262 하이투자증권
    263 현대차증권
    264 키움증권
    265 이베스트투자증권
    266 SK증권
    267 대신증권
    269 한화투자증권
    270 하나금융투자
    278 신한금융투자
    279 DB금융투자
    280 유진투자증권
    287 메리츠종합금융증권
    290 부국증권
    291 신영증권
    292 케이프투자증권
    294 펀드온라인코리아

  • accNum

    STRING 필수

    계좌번호

  • accName

    STRING 필수

    성명

  • orderID

    STRING 필수

    주문ID

    고객이 입력한 값
    요청 및 확인 시 해당값 리턴

  • authType

    STRING

    인증번호 유형

    계좌 입급자 항목에 들어가는 무작위 패턴
    1 : 숫자 3자리
    2 : 영문대문자 + 숫자 2자리
    3 : 한글단어 자동조합 4글자
    4 : 숫자4자리

  • senderName

    STRING

    송금인 명칭

    계좌 입금자 항목에 추가로 들어가는 문자

    예시)
    authType : 1
    senderName : 유디페이
    결과 - 유디페이123

    예시)
    authType : 2
    senderName : 유디페이
    결과 - 유디페이A01

    authType : 3 일 경우 입력된 송금인 명칭이 무시됨
    예시)
    senderName : 유디페이
    authType : 3
    결과 - 파란겨자

    authType : 3 일 경우 입력된 송금인 명칭이 최대 3글자
    예시)
    senderName : 유디페이
    authType : 3
    결과 - 오류메세지 (authType 값이 4일 경우 senderName 값을 최대 3글자를 입력할 수 있습니다.)

    senderName : 테스트
    authType : 3
    결과 - 테스트1234

  • senderNameLocation

    STRING

    송금인 명칭 위치

    인증번호 유형 기준으로 송금인 명칭 위치 지정
    예시)
    senderNameLocation : R
    authType : 1
    senderName : 유디페이
    결과 - 유디페이123

    senderNameLocation : F
    authType : 1
    senderName : 유디페이
    결과 - 123유디페이

  • authValidTime

    STRING

    인증 유효시간

    계좌점유인증 요청 성공 후 계좌점유인증 확인 호출 전까지 대기시간
    - 30~99999(초 단위)

  • authReTryTime

    STRING

    반복요청 방지 시간

    지정된 시간 내 반복적으로 요청하는 경우 1원 입금을 진행하지 않고 처리중으로 응답
    - 30~99999(초 단위)

  • state

    STRING 필수

    요청 결과

    true 성공, false 실패

  • message

    STRING

    메세지

    요청 결과 메세지

  • errorMessage

    STRING

    오류 메세지

    요청 결과에 대한 오류 메세지

  • errorType

    STRING

    오류 번호

    요청 결과에 대한 오류 번호

  • result

    OBJECT 필수

    결과 데이터

    • id

      STRING 필수

      요청ID

      계좌 점유인증 확인 요청 시 필수 값

    • state

      STRING

      계좌점유인증 상태

      AUTH_SUCCESS(계좌점유인증 요청 성공)
      AUTH_FAIL(계좌점유인증 요청 실패)

    • errMsg

      STRING

      계좌점유인증 오류 메세지

    • orderID

      STRING

      주문ID

      고객이 입력한 값

코드샘플
// https://mvnrepository.com/artifact/com.konghq/unirest-java/3.6.01

Map<String, Object> paramMap = new HashMap<> ();

paramMap.put ("code", "");	// 은행 코드
paramMap.put ("accNum", "");	// 계좌번호
paramMap.put ("accName", "");	// 성명
paramMap.put ("orderID", "");	// 주문ID
paramMap.put ("authType", "1");	// 인증번호 유형
paramMap.put ("senderName", "");	// 송금인 명칭
paramMap.put ("senderNameLocation", "R");	// 송금인 명칭 위치
paramMap.put ("authValidTime", "600");	// 인증 유효시간
paramMap.put ("authReTryTime", "600");	// 반복요청 방지 시간

HttpResponse response = Unirest.post("https://papi.udpay.co.kr/api/v1/account/requestAccountAuth")
.header("accept", "application/json")
.header("Content-Type", "application/json")
.header("pApiToken", "") // 연동토큰
.body(paramMap)
.asJson();

// JSONObject obj = response.getBody().getObject().getJSONObject("objKey");
// String strVal = obj.getString ("strKey");
// JSONArray arr = response.getBody().getObject().getJsonArray("arrayKey");
계좌점유인증 확인 요청
post

1원이 입금된 계좌가 맞는지 인증값을 확인합니다.

https://papi.udpay.co.kr/api/v1/account/checkAccountAuth

  • pApiToken

    STRING 필수

    연동토큰

    UDPAY 부가서비스 연동토큰

  • id

    STRING 필수

    요청ID

    계좌 점유인증 요청 성공 시 제공한 ID

  • authNo

    STRING 필수

    인증값

    1원이 입금된 계좌의 입금자 정보

  • state

    STRING 필수

    요청 결과

    true 성공, false 실패

  • message

    STRING

    메세지

    요청 결과 메세지

  • errorMessage

    STRING

    오류 메세지

    요청 결과에 대한 오류 메세지

  • errorType

    STRING

    오류 번호

    요청 결과에 대한 오류 번호

  • result

    OBJECT 필수

    결과 데이터

    • id

      STRING 필수

      요청ID

      계좌 점유인증 확인 요청 시 필수 값

    • state

      STRING

      계좌점유인증 상태

      CHECK_SUCCESS(계좌점유인증 확인 성공)
      CHECK_FAIL(계좌점유인증 확인 실패)

    • errMsg

      STRING

      계좌점유인증 오류 메세지

    • orderID

      STRING

      주문ID

      고객이 입력한 값

코드샘플
// https://mvnrepository.com/artifact/com.konghq/unirest-java/3.6.01

Map<String, Object> paramMap = new HashMap<> ();

paramMap.put ("id", "");	// 요청ID
paramMap.put ("authNo", "");	// 인증값

HttpResponse response = Unirest.post("https://papi.udpay.co.kr/api/v1/account/checkAccountAuth")
.header("accept", "application/json")
.header("Content-Type", "application/json")
.header("pApiToken", "") // 연동토큰
.body(paramMap)
.asJson();

// JSONObject obj = response.getBody().getObject().getJSONObject("objKey");
// String strVal = obj.getString ("strKey");
// JSONArray arr = response.getBody().getObject().getJsonArray("arrayKey");