Guide > 지급대행
지급대행
지급대행
지급대행 서비스 이용하기
지급대행은 오픈마켓에서 발생한 매출을 NHN KCP가 오픈마켓을 대신하여 셀러(오픈마켓 입점 하위몰)에게 지급하는 서비스입니다.
직접 다수의 셀러에게 정산을 진행할 필요 없이, 복잡한 정산 및 지급 업무를 NHN KCP에 맡겨 안정적이고 체계적으로 자금을 관리할 수 있습니다.
✅ 지급대행 서비스에 대한 자세한 설명은 API Reference의 서명데이터 메뉴를 참고해 주세요.
지급대행 서비스 흐름도
1. 서비스 인증서 적용하기
서비스 인증서는 가맹점 인증과 부인 방지를 위해 API 결제 서비스에서 사용돼요.
NHN KCP는 가맹점이 전달한 서비스 인증서 정보를 검증하고, 해당 결제 요청에 대한 결과를 응답합니다.
✅ 서비스 인증서에 대한 자세한 내용은 API Reference의 KCP PG-API를 확인해 주세요.
2. 셀러 등록하기
오픈마켓에서 정산금을 지급하기 위해서는 지급 대상인 셀러 정보를 NHN KCP에 사전 등록해야 해요.
등록되지 않은 셀러에게는 송금이 불가능합니다.
API 통신으로 셀러 등록을 요청하면 셀러 등록 처리된 정보가 리턴되니, 요청하신 정보와 일치한지 확인해 주세요.
{
"site_cd":"AO33D",
"kcp_cert_info":"-----BEGIN CERTIFICATE-----MII...puQ==-----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":"홍길동",
}
{
"res_cd":"AO33D",
"res_msg":"-----BEGIN CERTIFICATE-----MII...puQ==-----END CERTIFICATE-----",
"res_mall_info":"shop_001",
[{
"site_cd":"AO33D",
"kcp_cert_info":"-----BEGIN CERTIFICATE-----MII...puQ==-----END CERTIFICATE-----",
"seller_id":"shop_001",
"seller_name":"홍길동마켓",
"own_name":"홍길동",
"tax_no":"1231212345",
"tel_no":"02-1234-1234",
"seller_level":"CT02",
"bank_cd":"BK03",
"deposit_no":"1234567890",
"depositor":"홍길동",
}]
}
3. 셀러 조회하기
등록한 셀러 아이디(seller_id)와 셀러 등록일자(reg_dt)로 등록된 셀러의 정보를 확인할 수 있습니다.
셀러 아이디로 조회 요청 : seller 아이디와 일치하는 셀러 정보 리턴
셀러 등록일자로 조회요청 : 해당 일자에 등록된 모든 셀러 정보 리턴
4. 모계좌 조회하기
NHN KCP에 등록된 셀러의 사업자 정보나 계좌 정보가 변경된 경우에는 셀러 정보 수정 API를 통해 최신 정보로 반영해 주세요.
계좌 정보가 정확하지 않을 경우 송금 오류가 발생할 수 있으니 유의해 주세요.
또한, 사용이 중지된 셀러는 별도의 재등록 없이 상태 변경을 통해 재사용 처리할 수 있어요.
정보를 수정할 셀러 아이디(seller_id)는 필수로 전달하고, 그 외 값은 수정할 값에 대해서만 파라미터를 전달해 주세요.
Null 값으로 넘긴 파라미터가 있을 경우 오류가 발생합니다.
셀러 아이디를 재사용 처리할 때는 seller_id와 re_use 값만 요청합니다.
응답 전문은 정보 수정 처리된 정보만 리턴되며, 변경된 정보는 저장하여 관리해 주세요.
셀러의 전체 정보 확인이 필요하신 경우는 셀러 조회 전문으로 확인해 주세요.
5. 셀러 사용 중지하기
휴업, 폐업, 계약 종료 등으로 더 이상 정산이 필요 없는 셀러가 발생할 수 있습니다.
등록한 seller_id를 사용 중지 처리하며, 중지된 seller_id는 송금이 불가합니다.
중지된 seller_id는 정보 수정 기능을 통해 재사용 처리 할 수 있습니다.
6. 셀러 등록하기
가맹점의 모계좌는 정산 계좌와 동일해요.
정산 대금 지급 또는 셀러 이체 등으로 모계좌의 잔액은 계속 달라지며,
잔액이 부족한 상태에서 송금 요청 시 실패가 발생해요.
따라서 셀러에게 이체하기 전, 모계좌 조회 API로 모계좌의 송금 가능 잔액(can_amount)과 모계좌 정보를 확인해 주세요.
📍계좌번호(account)는 일부 마스킹되어 리턴됩니다.
{
"site_cd":"AO33D",
"kcp_cert_info":"-----BEGIN CERTIFICATE-----MII...puQ==-----END CERTIFICATE-----",
"pay_method":"VCNT",
"amount":"0",
"va_txtype":"48100000",
"currency":"410",
}
{
"res_cd":"AO33D",
"res_msg":"-----BEGIN CERTIFICATE-----MII...puQ==-----END CERTIFICATE-----",
"res_en_msg":"processing completed",
"app_time":"20250101172721",
"can_amount":"100000",
"bankcode":"BK03",
"depositor":"홍길동",
"account":"*********12345",
}
7. 송금하기
셀러에게 지급할 정산 금액을 확인했다면,
가맹점의 서비스인증서와 송금요청 전문을 송금 API URL로 전송하여 NHN KCP에 송금 요청을 합니다.
송금 응답 전문 중, 거래일련번호(trade_seq), 송금요청일자(trade_date)는 송금 상태조회에서 사용되는 값이니 저장하여 관리해 주세요.
해당 값은 등록된 셀러에 대한 송금 성공 및 실패에서 모두 리턴되며, 등록되지 않은 셀러 아이디로 송금을 시도 했을 경우에는 리턴되지 않습니다.
📍셀러 정산은 원화로만 가능해요.
🚨NHN KCP는 지급대행으로 셀러에게 지급한 정산 금액 '회수'와 같은 지급 관련 책임이 없기 때문에 지급대행 서비스를 신중하게 사용해 주세요.
8. 송금 상태 조회하기
셀러에게 지급할 정산 금액을 확인했다면,
송금 요청 후 은행 처리 과정에서 실패 및 지연이 발생할 수 있어요.
송금 상태 조회는 등록된 셀러에게 송금 요청 후 처리 상태 확인이 필요한 경우 시도합니다.
등록되지 않은 셀러에 대한 송금 요청은 trade_seq, trade_date가 리턴되지 않기 때문에 조회할 수 없어요.
아래의 경우 반드시 송금 상태 조회를 진행해야 하며, 이외 가맹점 판단 하에 송금 처리 상태 확인이
필요한 경우 송금 상태를 조회합니다.
1) 송금 요청의 결과코드가 ‘res_cd=0000’ 값이 아닌 경우
2) 송금 요청 후 가맹점 DB 처리 중 오류 발생한 경우
3) 송금 상태 조회 시 처리상태가 ‘status_code=6’인 경우
🚨이미 상태조회를 통해 송금완료 상태로 응답받은 건으로 재조회 할 경우 아래의 오류가 리턴돼요.
→ res_cd=8393, res_msg=이미 조회한 거래입니다.