◎ 전용페이 카드 단일 결제를 요청하는 경우
{
    "pgcode": "shpaycard",
    "client_id": "o2o",
    "user_id": "test_01",
    "user_name": "테스터01",
    "order_no": "202108311259590001",
    "pay_type”: 1,                                // 단일 결제
    "device_type": 1,
    "amount": 11000,
    "taxfree_amount": 0,
    "tax_amount": 90,
    "product_name": "테스트 상품",
    “param_ispt_hash”:”821b7bf742abfb49c8e535ee9a0801c4e6cefe4d49c9c8209b8c54d5077082f8"
    "email_flag": "Y",
    "email_addr": "bae1222@payletter.com",
    "pay_hash": "dfhuoi892ashiozxui123…”,
    "custom_parameter": "asdfoxuoy12uyisadouydfouayiouf…",
    "return_url": "https://o2odev.shinhan.com/partner/pay/approval",
    "cancel_url": "https://o2odev.shinhan.com/partner/pay/cancel",
    "fail_url": "https://o2odev.shinhan.com/partner/pay/fail",
    "card_purpost_type": 1,                    // 신용카드는 필수 설정
    "bill_key": "hoiu123yox134yauyxf",     // 전용페이 결제수단 등록 시 발급되는 고유 식별 정보
    “cup_return_deposit”: “100” ,            // 컵반환 보증금
    “prepay_amount”: 2000                  // 선불전자지급수단을 사용할 경우 필수 설정
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "redirect_url": "https://devpayapispg.shinhan.com/pgsvc/pay?token=2021083110239001duf.." // (결제 인증용)웹 화면
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

◎ 개인용 통합결제창 결제를 요청하는 경우
{
    "pgcode": "selpay",
    "client_id": "o2o",
    "user_id": "test_01",
    "user_name": "테스터01",
    "order_no": "202108311259590001",
    "pay_type”: 1,    // 단일 결제
    "device_type": 1,
    "amount": 11000,
    "product_name": "테스트 상품",
    "return_url": "https://o2odev.shinhan.com/partner/pay/approval",
    "cancel_url": "https://o2odev.shinhan.com/partner/pay/cancel",
    "fail_url": "https://o2odev.shinhan.com/partner/pay/fail",
    “param_ispt_hash”:”821b7bf742abfb49c8e535ee9a0801c4e6cefe4d49c9c8209b8c54d5077082f8"
    "taxfree_amount": 0,
    "tax_amount": 90,
    "email_flag": "Y",
    "email_addr": "bae1222@payletter.com",
    "pay_hash": "dfhuoi892ashiozxui123…”,
    "custom_parameter": "asdfoxuoy12uyisadouydfouayiouf…",
    "card_purpost_type": 1,                  // 일반 신용카드는 필수 설정
    "app_return_url": "scheme://path",    // 모바일 앱 환경의 일반 신용카드는 필수 설정
    "app_cancel_url": "scheme://path",    // 모바일 앱 환경의 일반 신용카드는 필수 설정
    “cup_return_deposit”: “100”,         // 컵반환 보증금
    “card_cpny_cd”: “S005”,               // 고객사 화면에서 카드사를 선택하여 결제요청하는 경우 필수 설정
}
                                

◎ 법인용 통합결제창 결제를 요청하는 경우
{
    "pgcode": "bizselpay",
    "client_id": "o2o",
    "user_id": "test_01",
    "user_name": "테스터01",
    "order_no": "202108311259590001",
    "pay_type”: 1,             // 단일 결제
    "device_type": 2,         // 법인은 PC전용
    "amount": 11000,
    "taxfree_amount": 0,
    "tax_amount": 1000,
    "product_name": "테스트 상품",
    “param_ispt_hash”:”821b7bf742abfb49c8e535ee9a0801c4e6cefe4d49c9c8209b8c54d5077082f8"
    "email_flag": "Y",
    "email_addr": "bae1222@payletter.com",
    "pay_hash": "dfhuoi892ashiozxui123…”,
    "custom_parameter": "asdfoxuoy12uyisadouydfouayiouf…",
    “cup_return_deposit”: “100” ,            // 컵반환 보증금,
    “buyr_bizr_no”:”1234567890”,
    “clnt_pay_clf_cd”:”20240208”,
    “req_amt”: 700000000,
    “chrg_amt”: 300000000,
    “tot_tx_amt”: 1000000000,
    “pay_amt”: 1000000000,
    “clnt_tx_clf_cd”:”IMPL”,
    “cncl_yn”:”N”,
    “clnt_tx_ymd”:”20240601”,
    “seller_name”:”테스트판매사”
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "redirect_url": "https://devpayapispg.shinhan.com/pgsvc/pay?token=2021083110239001duf.." // (결제 인증용)웹 화면
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

1.Html 내 script tag 추가
<script src="https://payspg.shinhan.com/businessPayment/unifiedPay/script"></script>

2.통합결제창 결제요청 응답값 (redirect_url) 으로 팝업 호출
ShinhanBizPay.openPopup(result.redirect_url, function(retCode, retMessage) {
    if(retCode == ShinhanBizPay.RES_SUCCESS) {
        console.log(“성공”);
    } else {
        console.log("실패”, retMessage);
    }
});
                                

HTTP 1.1 200 OK
{
    "order_no": "202108310937510001",
    "custom_parameter": "auoh1238u123uy...",
    "confinm_token": "aaaaaa.bbbbbb.ccccc"
    “escr_yn”:”N”
    “tid”:”거래번호”
    "bank_nm": "입금은행",
    "user_nm": "예금주명",
    "vald_dt": "20240909"
    "gods_nm": "상품명"
    "email": "aaaaaa@ccc.com"
    "user_tel_no": "01012345678"
    "pay_amt": "46000"
    "ret_code": 0,
    "ret_msg": "OK"
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    “pay_type": 2,     // 결제 유형 (2: 복합 일반)
    "order_no": "202108311259590001",
    "product_name": "테스트 상품",
    "user_id": "test01",
    "user_name": "test01",
    "amount": "1000",
    "discount_amount": "100",
    "taxfree_amount": "0",
    "tax_amount": "90",
    "tid": "202108311259590006",
    "install_month": "00",
    "pay_ispt_hash": "941365C04218FF129B790AB1244F8A012BA64E872C3CB8E0C9978A2F76C202F0",
    "tx_date": "2021-08-31 12:59:59",
    "pay_info": [
        {
            … …
    }]
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "tid" :"tpay_test202108311259590002",
    "cid":"123456",
    "amount":1000,
    "tx_date":"2021-08-31 15:01:07"
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "tid" :"tpay_test202108311259590002",
    "cid":"123456",
    "amount":1000,
    "tx_date":"2021-08-31 15:01:07"
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "redirect_url": "https://devpayapispg.shinhan.com/pgsvc/o2opay...?token=202100235959.." // (전용페이 관리용)웹 화면
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

{
    "ret_code": 0,
    "ret_msg": "OK",
    "pgcode": "shpaycard",
    "bill_key": "auoh1238u123uy...",
    “xclv_pay_user_no”: 1
}
                                

{
    "ret_code": 0,
    "ret_msg": "OK",
    "ispt_hash": "auoh1238u123uy..."
}
                                

{
    "ret_code": 0,
    "ret_msg": "OK"
}
                                

{
    "ret_code": 999,
    "ret_msg": "user ci is missing or incorrect."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "pwd_use_yn": "Y"
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK"
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK"
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "client_id": "o2o",
    "user_id": "test_01",
    "pwd_use_yn": "Y",
    "total_count": 3,
    "list": [
        {
            "pgcode": "shpaycard",
            "bill_key": "aadhouzxx22389…”,
            "instt_name”: "신한카드",
            "instt_pay_no”: "123***9001",
            "image_url": "https://...",
            "fav_yn": “Y”,
            “product_code”: “BJBBE4”,
            “bank_card_cd”: “S005”,
            “instt_service_stat_type”: “1”,    //정상
            “instt_service_noti_msg”: “”
        },
        {
            "pgcode": "shpaybank",
            "bill_key": "8jkmn23oyufoeho17…”,
            "instt_name”: "신한은행",
            "instt_pay_no”: "123***9001",
            "image_url": "https://...",
            "fav_yn": “N”,
            “bank_card_cd”: “088” ,
            “instt_service_stat_type”: “2”,       //서비스불가
            “instt_service_noti_msg”: “신한은행 서비스 장애”
        }
    ]
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "instt_cd": "088",
    "acct_no": "123456789..."
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "pub_tid": "20210831duahuhwqyjdshlhfkljaajhflasdfuoiwueyo1uyde" // 발행 거래번호
    “aprv_no”; “13341477”
    “pub_type”: 1
    “pub_clf_type”: 1
    “pub_no”: “010-000-1234”
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "pub_tid" : "o2o2023110914070153800023096",
    "pub_type": 1 ,
    "pub_clf_type": 1 ,
    "pub_no_type": 1,
    "pub_no": 01012345678,
    "tx_type": 1,
    "tx_amount": 2000,
    "aprv_no": "J20000036",
    "proc_stat": 1
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "there is no data."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "redirect_url": "https://devpayapispg.shinhan.com/pgsvc/receipt/receipt_all.asp?id=..." //(거래내역확인용) PG 웹 화면
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "user_id": "test_01",
    "tid": "202108311259590006",
    "tax_amount": "10,00",
    "tx_stat": 2,
    "tx_date": "2021-12-22 12:59:59",
    "cncl_date": "2021-12-22 13:05:59",
    "cncl_rsn”: “고객 요청”
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "there is no data."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    “list”: {
        "card_cpny_cd": "S001",
        "card_cpny_name": "BC카드",
        "image_url": "/srs/htdocs/publish/images/icon_card_bc.png"
    }
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "there is no data."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    “oneclick”: "ON",
    “ui_type”: “Y”,
    "list_count": 1,
    list": [{
        "card_brand_name":"현대카드M2",
        "card_num_mask":"4***********101*",
        "acnt_id": "TVPAY2021011111111100000017273",
        "card_code":"2077",
        "card_name":"현대카드",
        "user_no":"M0000000040",
        "install_ment_yn":"Y",
        "is_oneclick":"Y"
    }]
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "there is no data."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    list": [{
    "terms_no": 1,
    "terms_nm":"전자금융거래 이용약관",
    "terms_ctnt": “<header class=”pgHeader”><h3 class=”title”>약관 및 동의</h3>….</div>"
    }]
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "there is no data."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "redirect_url": "https://devpayapispg.shinhan.com/pgsvc/pay?token=2021083110239001duf.." // (결제 인증용)웹 화면
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "user_id": "test_01",
    "rpay_billkey": "auoh1238u123uy...",
    "card_billkey": "hkjf1238u123uy...",
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "token is missing or incorrect."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    “list”: {
        "card_cpny_cd": "S001",
        "card_cpny_name": "BC카드"
    }
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "there is no data."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK",
    "list_count": 1,
    “oneclick_on_off”: "ON",
    list": [{
        "card_brand_name":"현대카드M2",
        "card_num_mask":"4***********101*",
        "acnt_id": "TVPAY2021011111111100000017273",
        "card_code":"2077",
        "card_name":"현대카드",
        "user_no":"M0000000040",
        "install_ment_yn":"Y",
        "is_oneclick":"Y"
    }]
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "there is no data."
}
                                

HTTP 1.1 200 OK
{
    "ret_code": 0,
    "ret_msg": "OK"
}
                                

HTTP 1.1 401 Unauthorized
{
    "ret_code": 998,
    "ret_msg": "there is no data."
}