API Reference > 지급대행

지급대행

지급대행 API는 셀러 등록부터 송금 및 송금 상태 조회까지 지급대행 업무에 필요한 기능을 제공합니다.

셀러 등록

테스트 : https://stg-spl.kcp.co.kr/std/submall/write
운영 : https://spl.kcp.co.kr/std/submall/write

Request Body 파라미터

{
    "site_cd"       : "AO33D",
    "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHBy4lYNG7ojANBgkqhkiG9w0……………fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
    "seller_id"     : "shop_001",
    "seller_name"   : "홍길동마켓",
    "own_name"      : "홍길동",
    "address"       : "서울시 구로구 구로동",
    "tel_no"        : "02-1234-1234",
    "seller_level"  : "CT02",
    "tax_no"        : "1212312345",
    "bank_cd"       : "BK03",
    "deposit_no"    : "1234567890",
    "depositor"     : "홍길동"
}

string 5

site_cd 필수

NHN KCP와 계약 시 가맹점 고유의 값으로 발급된 코드입니다.
영문대문자 또는 영문 대문자+숫자로 구성됩니다. 모든 서비스에 사용합니다.
ex) "site_cd" : "AO33D"

string 가변

kcp_cert_info 필수

NHNKCP 에서 발급하는 서비스 인증서로, 모든 서비스에서 사용됩니다.
상점관리자의 인증센터에서 다운받은 pem 파일 내용을 직렬화하여 사용합니다.
ex) "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHBy4lYNG7ojANBgkqhkiG9w0……………fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----"

string 50

seller_id 필수

가맹점에서 seller를 구분할 수 있는 값으로, seller별로 유니크한 값으로 설정합니다.
ex) "seller_id" : "shop_001"

string 80

seller_name 필수

seller의 상호명입니다.
ex) "seller_name" : "홍길동마켓"

string 40

own_name 필수

seller의 대표자명입니다.
ex) "own_name" : "홍길동"

string 200

address 필수

seller의 주소입니다.
ex) "address" : "서울시 구로구 구로동"

string 15

tel_no 필수

seller의 연락처입니다.
ex) "tel_no" : "02-1234-1234"

string 4

seller_level 필수

seller의 사업자 구분입니다.
CT01 : 법인사업자
CT02 : 개인사업자
ex) "seller_level" : "CT02"

string 10

tax_no 필수

seller의 사업자번호입니다.
ex) "tax_no" : "1212312345"

string 4

bank_cd 필수

seller의 계좌정보 중 은행코드입니다.
은행코드를 참고 바랍니다.
ex) "bank_cd" : "BK03"

string 16

deposit_no 필수

seller의 계좌정보 중 계좌번호입니다. ("-" 은 포함하지 않습니다.)
ex) "deposit_no" : "1234567890"

string 40

depositor 필수

seller의 계좌정보 중 예금주명입니다.
ex) "depositor" : "홍길동"

Response 파라미터

{
    "res_cd" : "0000",
    "res_msg" : "성공",
    "res_en_msg" : "processing completed",
    "res_mall_info" : [
        {
            "site_cd" : "AO33D",
            "seller_id" : "shop_001",
            "seller_name" : "홍길동마켓",
            "own_name" : "홍길동",
            "tax_no" : "1231212345",
            "address" : "구로구",
            "tel_no" : "0212341234",
            "seller_level" : "CT02",
            "bank_cd" : "BK03",
            "deposit_no" : "1234567890",
            "depositor" : "홍길동"
        }
    ]
}

string 4

res_cd always

결과 코드입니다. 정상 처리 된 경우 "0000" 을 리턴합니다.
"0000" 이외의 결과 코드는 오류 응답이니 사유를 확인하시기 바라며 가맹점 DB처리시 참고바랍니다.
ex) "res_cd" : "0000"

string 100

res_msg always

요청에 대한 결과 메시지입니다. 정상 처리 시에는 "성공"이 리턴됩니다.
ex) "res_msg" : "성공"

string 100

res_en_msg always

요청에 대한 결과 영문메시지입니다. 정상 처리 시에는 "processing completed"가 리턴됩니다.
ex) "res_en_msg" : "processing completed"

string 가변

res_mall_info success

seller 정보이며, JSON Array 형식으로 리턴됩니다.

string 5

site_cd success

사이트코드 입니다.
ex) "site_cd" : "AO33D"

string 50

seller_id success

seller 아이디입니다.
ex) "seller_id" : "shop_001"

string 80

seller_name success

seller의 상호명입니다.
ex) "seller_name" : "홍길동마켓"

string 40

own_name success

seller의 대표자명입니다.
ex) "own_name" : "홍길동"

string 200

address success

seller의 주소입니다.
ex) "address" : "서울시 구로구 구로동"

string 15

tel_no success

seller의 연락처입니다.
ex) "tel_no" : "02-1234-1234"

string 4

seller_level success

seller의 사업자 구분입니다.
CT01 : 법인사업자
CT02 : 개인사업자
ex) "seller_level" : "CT02"

string 10

tax_no success

seller의 사업자번호입니다.
ex) "tax_no" : "1212312345"

string 4

bank_cd success

seller의 계좌정보 중 은행코드입니다.
은행코드를 참고 바랍니다.
ex) "bank_cd" : "BK03"

string 16

deposit_no success

seller의 계좌정보 중 계좌번호입니다. ("-" 은 포함하지 않습니다.)
ex) "deposit_no" : "1234567890"

string 40

depositor success

seller의 계좌정보 중 예금주명입니다.
ex) "depositor" : "홍길동"

셀러 조회

테스트 : https://stg-spl.kcp.co.kr/std/submall/read
운영 : https://spl.kcp.co.kr/std/submall/read

Request Body 파라미터

{
    "site_cd" : "AO33D",
    "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHBy4lYNG7ojANBgkqhkiG9w0……………fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
    "seller_id" : "shop_001"
}

string 5

site_cd 필수

string 가변

kcp_cert_info 필수

string 50

seller_id 조건부 필수

조회 요청할 seller 아이디입니다.
ex) "seller_id" : "shop_001"

string 8

reg_dt 조건부 필수

조회 요청할 seller 등록일자 입니다.
ex) "reg_dt" : "20250101"

Response 파라미터

{
    "res_cd" : "0000",
    "res_msg" : "성공",
    "res_en_msg" : "processing completed",
    "res_mall_info" : [
        {
            "site_cd" : "AO33D",
            "seller_id" : "shop_001",
            "seller_name" : "홍길동마켓",
            "own_name" : "홍길동",
            "tax_no" : "1231212345",
            "address" : "구로구",
            "tel_no" : "0212341234",
            "seller_level" : "CT02",
            "bank_cd" : "BK03",
            "deposit_no" : "******67890",
            "depositor" : "홍길동",
            "reg_dt" : "20250101120101"
        }
    ]
}

string 4

res_cd always

string 100

res_msg always

요청에 대한 결과 메시지입니다. 정상 처리 시에는 "성공"이 리턴됩니다.
ex) "res_msg" : "성공"

string 100

res_en_msg always

요청에 대한 결과 영문메시지입니다. 정상 처리 시에는 "processing completed"가 리턴됩니다.
ex) "res_en_msg" : "processing completed"

string 가변

res_mall_info success

seller 정보이며, JSON Array 형식으로 리턴됩니다.

string 5

site_cd success

사이트코드 입니다.
ex) "site_cd" : "AO33D"

string 50

seller_id success

seller 아이디입니다.
ex) "seller_id" : "shop_001"

string 80

seller_name success

seller의 상호명입니다.
ex) "seller_name" : "홍길동마켓"

string 40

own_name success

seller의 대표자명입니다.
ex) "own_name" : "홍길동"

string 10

tax_no success

seller의 사업자번호입니다.
ex) "tax_no" : "1212312345"

string 200

address success

seller의 주소입니다.
ex) "address" : "서울시 구로구 구로동"

string 15

tel_no success

seller의 연락처입니다.
ex) "tel_no" : "02-1234-1234"

string 4

seller_level success

seller의 사업자 구분입니다.
CT01 : 법인사업자
CT02 : 개인사업자
ex) "seller_level" : "CT02"

string 4

bank_cd success

seller의 계좌정보 중 은행코드입니다.
은행코드를 참고 바랍니다.
ex) "bank_cd" : "BK03"

string 16

deposit_no success

seller의 계좌정보 중 계좌번호입니다. ("-" 은 포함하지 않습니다.)
ex) "deposit_no" : "1234567890"

string 40

depositor success

seller의 계좌정보 중 예금주명입니다.
ex) "depositor" : "홍길동"

string 14

reg_dt success

seller 를 등록한 시각입니다.
ex) "reg_dt" : "20250101120101"

셀러 정보 수정

테스트 : https://stg-spl.kcp.co.kr/std/submall/update
운영 : https://spl.kcp.co.kr/std/submall/update

Request Body 파라미터

{
    "site_cd" : "AO33D",
    "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHBy4lYNG7ojANBgkqhkiG9w0……………fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
    "seller_id" : "shop_001",
    "bank_cd" : "BK04",
    "deposit_no" : "9876543210",
    "depositor" : "홍길순"
}

string 5

site_cd 필수

string 가변

kcp_cert_info 필수

string 50

seller_id 필수

정보수정할 seller 아이디를 설정합니다.
ex) "seller_id" : "shop_001"

string 80

seller_name

seller의 상호명입니다.
ex) "seller_name" : "홍길동마켓"

string 40

own_name

seller의 대표자명입니다.
ex) "own_name" : "홍길동"

string 200

address

seller의 주소입니다.
ex) "address" : "서울시 구로구 구로동"

string 15

tel_no

seller의 연락처입니다.
ex) "tel_no" : "02-1234-1234"

string 4

seller_level

seller의 사업자 구분입니다.
CT01 : 법인사업자
CT02 : 개인사업자
ex) "seller_level" : "CT02"

string 10

tax_no

seller의 사업자번호입니다.
ex) "tax_no" : "1212312345"

string 4

bank_cd

seller의 계좌정보 중 은행코드입니다.
은행코드를 참고 바랍니다.
계좌정보 수정 시에는 bank_cd, deposit_no, depositor을 모두 전달해야합니다.
ex) "bank_cd" : "BK03"

string 16

deposit_no

seller의 계좌정보 중 계좌번호입니다. ("-" 은 포함하지 않습니다.)
계좌정보 수정 시에는 bank_cd, deposit_no, depositor을 모두 전달해야합니다.
ex) "deposit_no" : "1234567890"

string 40

depositor

seller의 계좌정보 중 예금주명입니다.
계좌정보 수정 시에는 bank_cd, deposit_no, depositor을 모두 전달해야합니다.
ex) "depositor" : "홍길동"

string 1

re_use

사용중지된 seller을 재사용 처리할 경우 Y로 설정합니다.
N 값은 허용되지 않으며, 사용중지 처리는 사용중지 API를 사용합니다.
ex) "re_use" : "Y"

Response 파라미터

{
    "res_cd" : "0000",
    "res_msg" : "성공",
    "res_en_msg" : "processing completed",
    "res_mall_info" : [
        {
            "site_cd" : "AO33D",
            "seller_id" : "shop_001",
            "bank_cd" : "BK04",
            "deposit_no" : "9876543210",
            "depositor" : "홍길순"
        }
    ]
}

string 4

res_cd always

string 100

res_msg always

요청에 대한 결과 메시지입니다. 정상 처리 시에는 "성공"이 리턴됩니다.
ex) "res_msg" : "성공"

string 100

res_en_msg always

요청에 대한 결과 영문메시지입니다. 정상 처리 시에는 "processing completed"가 리턴됩니다.
ex) "res_en_msg" : "processing completed"

string 가변

res_mall_info success

seller 정보이며, JSON Array 형식으로 리턴됩니다.

string 5

site_cd success

사이트코드 입니다.
ex) "site_cd" : "AO33D"

string 50

seller_id success

seller 아이디입니다.
ex) "seller_id" : "shop_001"

string 80

seller_name success

seller의 상호명입니다.
ex) "seller_name" : "홍길동마켓"

string 40

own_name success

seller의 대표자명입니다.
ex) "own_name" : "홍길동"

string 200

address success

seller의 주소입니다.
ex) "address" : "서울시 구로구 구로동"

string 15

tel_no success

seller의 연락처입니다.
ex) "tel_no" : "02-1234-1234"

string 4

seller_level success

seller의 사업자 구분입니다.
CT01 : 법인사업자
CT02 : 개인사업자
ex) "seller_level" : "CT02"

string 10

tax_no success

seller의 사업자번호입니다.
ex) "tax_no" : "1212312345"

string 4

bank_cd success

seller의 계좌정보 중 은행코드입니다.
은행코드를 참고 바랍니다.
ex) "bank_cd" : "BK03"

string 16

deposit_no success

seller의 계좌정보 중 계좌번호입니다. ("-" 은 포함하지 않습니다.)
ex) "deposit_no" : "1234567890"

string 40

depositor success

seller의 계좌정보 중 예금주명입니다.
ex) "depositor" : "홍길동"

셀러 사용중지

테스트 : https://stg-spl.kcp.co.kr/std/submall/delete
운영 : https://spl.kcp.co.kr/std/submall/delete

Request Body 파라미터

{
    "site_cd" : "AO33D",
    "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHBy4lYNG7ojANBgkqhkiG9w0……………fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
    "seller_id" : "shop_001"
}

string 5

site_cd 필수

string 가변

kcp_cert_info 필수

string 50

seller_id 필수

사용중지 할 seller 아이디를 설정합니다.
ex) "seller_id" : "shop_001"

Response 파라미터

{
    "res_cd" : "0000",
    "res_msg" : "성공",
    "res_en_msg" : "processing completed",
    "res_mall_info" : [
        {
            "site_cd" : "AO33D",
            "seller_id" : "shop_001"
        }
    ]
}

string 4

res_cd always

string 100

res_msg always

요청에 대한 결과 메시지입니다. 정상 처리 시에는 "성공"이 리턴됩니다.
ex) "res_msg" : "성공"

string 100

res_en_msg always

요청에 대한 결과 영문메시지입니다. 정상 처리 시에는 "processing completed"가 리턴됩니다.
ex) "res_en_msg" : "processing completed"

string 가변

res_mall_info success

seller 정보이며, JSON Array 형식으로 리턴됩니다.

string 5

site_cd success

사이트코드 입니다.
ex) "site_cd" : "AO33D"

string 50

seller_id success

seller 아이디입니다.
ex) "seller_id" : "shop_001"

모계좌 잔액조회

테스트 : https://stg-spl.kcp.co.kr/gw/hub/v1/payment
운영 : https://spl.kcp.co.kr/gw/hub/v1/payment

Request Body 파라미터

{
    "site_cd" : "AO33D",
    "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHBy4lYNG7ojANBgkqhkiG9w0……………fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
    "pay_method" : "VCNT",
    "amount" : "0",
    "va_txtype" : "48100000",
    "currency" : "410"
}

string 5

site_cd 필수

string 가변

kcp_cert_info 필수

string 4

pay_method 필수

결제수단으로 모계좌 잔액조회 시 "VCNT"으로 고정 값입니다.
ex) "pay_method" : "VCNT"

number 9

amount 필수

모계좌 잔액조회 시 "0"으로 고정 값입니다.
ex) "amount" : "0"

string 3

currency 필수

화폐단위입니다. 모계좌 잔액조회 시 "410(원화)"로 고정 값입니다.
ex) "currency" : "410"

string 8

va_txtype 필수

요청 전문 유형입니다. 모계좌 잔액조회 시 "48100000"로 고정 값입니다.
ex) "va_txtype" : "48100000"

Response 파라미터

{
    "res_cd" : "0000",
    "res_msg" : "정상처리",
    "res_en_msg" : "processing completed",
    "app_time" : "20250101172721",
    "can_amount" : "100000",
    "bankcode" : "BK03",
    "depositor" : "홍길동",
    "account" : "********12345"
}

string 4

res_cd always

string 100

res_msg always

요청에 대한 결과 메시지입니다. 정상 처리 시에는 "정상처리"가 리턴됩니다.
ex) "res_msg" : "정상처리"

string 100

res_en_msg always

요청에 대한 결과 영문메시지입니다. 정상 처리 시에는 "processing completed"가 리턴됩니다.
ex) "res_en_msg" : "processing completed"

string 14

app_time success

모계좌를 조회한 시각입니다.
ex) "app_time" : "20250101235959"

number 9

can_amount success

모계좌에서 송금 가능한 잔액입니다.
ex) "can_amount" : "100000"

string 4

bankcode success

모계좌의 은행코드입니다.
은행코드를 참고 바랍니다.
ex) "bankcode" : "BK03"

string 50

bankname success

모계좌의 은행명입니다.
ex) "bankname" : "기업은행"

string 16

account success

모계좌의 계좌번호입니다. 일부 마스킹되어 리턴됩니다. ("-" 은 포함하지 않습니다.)
ex) "account" : "********12345"

string 40

depositor success

모계좌의 예금주명입니다.
ex) "depositor" : "NHN KCP"

송금

테스트 : https://stg-spl.kcp.co.kr/gw/hub/v1/payment
운영 : https://spl.kcp.co.kr/gw/hub/v1/payment

Request Body 파라미터

{
    "site_cd" : "AO33D",
    "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHBy4lYNG7ojANBgkqhkiG9w0……………fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
    "pay_method" : "VCNT",
    "remit_type" : "S",
    "currency" : "410",
    "seller_id" : "shop_001",
    "amount" : "1000",
    "va_txtype" : "48200000",
    "va_name" : "테스트몰",
    "va_mny" : "1000"
}

string 5

site_cd 필수

string 가변

kcp_cert_info 필수

string 4

pay_method 필수

결제수단으로 송금 요청 시 "VCNT"으로 고정 값입니다.
ex) "pay_method" : "VCNT"

string 1

remit_type 필수

송금타입으로, "S"로 고정 값입니다.
ex) "remit_type" : "S"

number 9

amount 필수

seller에게 송금할 금액을 설정합니다. va_mny와 동일한 금액으로 설정합니다.
ex) "amount" : "1000"

string 3

currency 필수

화폐단위입니다. 모계좌 잔액조회 시 "410(원화)"로 고정 값입니다.
ex) "currency" : "410"

string 8

va_txtype 필수

요청 전문 유형입니다. 송금 요청 시 "48200000"로 고정 값입니다.
ex) "va_txtype" : "48200000"

number 9

va_mny 필수

seller에게 송금할 금액을 설정합니다. amount와 동일한 금액으로 설정합니다.
ex) "va_mny" : "1000"

string 50

seller_id 필수

송금 할 seller 아이디입니다.
ex) "seller_id" : "shop_001"

string 14

va_name

입금계좌에 표기되는 입금자명입니다. 값을 지정하지 않는 경우 NHN KCP에 설정된 값으로 표기됩니다.
ex) "va_name" : "테스트몰"

Response 파라미터

{
    "res_cd" : "0000",
    "res_msg" : "정상처리",
    "res_en_msg" : "processing completed",
    "app_time" : "20250101125956",
    "van_apptime" : "20250101125959",
    "trade_seq" : "25848002895020",
    "trade_date" : "20250101",
    "amount" : "1000",
    "bal_amount" : "99000",
    "bankname" : "NH농협",
    "bankcode" : "BK11",
    "account" : "******06302",
    "depositor" : "NHN KCP",
}

string 4

res_cd always

string 100

res_msg always

요청에 대한 결과 메시지입니다. 정상 처리 시에는 "정상처리"가 리턴됩니다.
ex) "res_msg" : "정상처리"

string 100

res_en_msg always

요청에 대한 결과 영문메시지입니다. 정상 처리 시에는 "processing completed"가 리턴됩니다.
ex) "res_en_msg" : "processing completed"

string 14

trade_seq always

거래일련번호입니다. 거래 건의 고유한 값으로, 등록되지 않은 셀러에게 송금 요청했을 때를 제외하고 송금 성공과 실패 응답에서 리턴됩니다.
송금 상태 조회 시 필요한 값으로 가맹점에서 관리해주셔야 하는 값입니다.
ex) "trade_seq" : "25848002895020"

string 8

trade_date always

송금을 요청한 일자입니다. 등록되지 않은 셀러에게 송금 요청했을 때를 제외하고 송금 성공과 실패 응답에서 리턴됩니다. 송금 상태 조회 시 필요한 값으로 가맹점에서 관리해주셔야 하는 값입니다.
ex) "trade_date" : "20250101"

number 9

amount success

송금 처리된 금액입니다.
ex) "amount" : "1000"

number 9

bal_amount success

송금 처리 후 모계좌에 남은 잔액입니다.
ex) "bal_amount" : "99000"

string 4

bankcode success

송금한 seller의 은행코드입니다.
은행코드를 참고 바랍니다.
ex) "bankcode" : "BK03"

string 14

app_time success

송금요청 시각입니다.
ex) "app_time" : "20250101125956"

string 14

van_apptime success

기관 송금 처리 시각입니다.
ex) "van_apptime" : "20250101125959"

string 50

bankname success

송금한 seller의 은행명입니다.
ex) "bankname" : "기업은행"

string 16

account success

송금한 seller의 계좌번호입니다. ("-" 은 포함하지 않습니다.)
ex) "account" : "******67890"

string 40

depositor success

모계좌 예금주명입니다.
ex) "depositor" : "NHN KCP"

송금 상태 조회

테스트 : https://stg-spl.kcp.co.kr/gw/hub/v1/payment
운영 : https://spl.kcp.co.kr/gw/hub/v1/payment

Request Body 파라미터

{
    "site_cd" : "AO33D",
    "kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHBy4lYNG7ojANBgkqhkiG9w0……………fWn5Cay7pJNWXCnw4jIiBsTBa3q95RVRyMEcDgPwugMXPXGBwNoMOOpuQ==-----END CERTIFICATE-----",
    "pay_method" : "VCNT",
    "amount" : "0",
    "currency" : "410",
    "va_txtype" : "48300000",
    "va_trade_date" : "20250101",
    "va_trade_seq" : "25848002895020"
}

string 5

site_cd 필수

NHN KCP와 계약 시 가맹점 고유의 값으로 발급된 코드입니다.
영문대문자 또는 영문 대문자 + 숫자로 구성됩니다. 모든 서비스에 사용합니다.
ex) "site_cd" : "AO33D"

string 가변

kcp_cert_info 필수

string 4

pay_method 필수

결제수단으로 송금 상태 조회 시 "VCNT"으로 고정 값입니다.
ex) "pay_method" : "VCNT"

number 9

amount 필수

송금 상태 조회 시 "0"으로 고정 값입니다.
ex) "amount" : "0"

string 3

currency 필수

화폐단위입니다. 송금 상태 조회 시 "410(원화)"로 고정 값입니다.
ex) "currency" : "410"

string 8

va_txtype 필수

요청 전문 유형입니다. 송금 상태조회 시 "48300000"로 고정 값입니다.
ex) "va_txtype" : "48300000"

string 8

va_trade_date 필수

거래일자입니다. 송금 요청 시 응답받은 trade_date를 설정합니다.
ex) "va_trade_date" : "20250101"

string 14

va_trade_seq 필수

거래일련번호입니다. 송금 요청 시 응답받은 trade_seq를 설정합니다.
ex) "va_trade_seq" : "25848002895020"

Response 파라미터

{
    "res_cd" : "0000",
    "res_msg" : "정상처리",
    "res_en_msg" : "processing completed",
    "status_code" : "1",
    "app_time" : "20250101235956",
    "van_apptime" : "20250101235959",
    "account" : "******06302",
    "bankname" : "NH농협",
    "bankcode" : "BK11",
    "amount" : "1000",
    "depositor" : "NHN KCP"
}

string 4

res_cd always

string 100

res_msg always

요청에 대한 결과 메시지입니다. 정상 처리 시에는 "정상처리"가 리턴됩니다.
ex) "res_msg" : "정상처리"

string 100

res_en_msg always

요청에 대한 결과 영문메시지입니다. 정상 처리 시에는 "processing completed"가 리턴됩니다.
ex) "res_en_msg" : "processing completed"

string 1

status_code success

송금 처리 상태입니다.
1 : 송금완료
3 : 송금실패
6 : 처리중
ex) "status_code" : "1"

string 14

app_time success

송금 요청 시각입니다.
ex) "app_time" : "20250101235956"

string 14

van_apptime success

기관 송금 처리 시각입니다.
ex) "van_apptime" : "20250101235959"

number 9

amount success

송금 처리된 금액입니다.
ex) "amount" : "1000"

string 4

bankcode success

송금한 seller의 은행코드입니다.
은행코드를 참고 바랍니다.
ex) "bankcode" : "BK03"

string 50

bankname success

송금한 seller의 은행명입니다.
ex) "bankname" : "기업은행"

string 16

account success

송금한 seller의 계좌번호입니다. ("-" 은 포함하지 않습니다.)
ex) "account" : "*********12345"

string 40

depositor success

모계좌 예금주명입니다.
ex) "depositor" : "NHN KCP"

지급대행

지급대행

셀러 등록

Request Body 파라미터

Response 파라미터

셀러 조회

Request Body 파라미터

Response 파라미터

셀러 정보 수정

Request Body 파라미터

Response 파라미터

셀러 사용중지

Request Body 파라미터

Response 파라미터

모계좌 잔액조회

Request Body 파라미터

Response 파라미터

송금

Request Body 파라미터

Response 파라미터

송금 상태 조회

Request Body 파라미터

Response 파라미터

문서 목차