가상계좌

가상계좌 입금 노티

post

기능설명

이니시스 가상계좌 입금 노티 수신 (PC/모바일 통합)

상세설명

• 이니시스 가상계좌 입금 노티를 수신하여 주문 정보를 업데이트합니다.

• 주문 정보 업데이트 성공 시, 현금영수증 발급 및 주문 완료 알림 메시지를 전송합니다.

Query parameters

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

text/plain

stringOptionalExample: OK

900

실패

text/plain

post

/v1/inicis/vbank/noti

HTTPcURLJavaScriptPython

POST /api/order/v1/inicis/vbank/noti?params=[object+Object] HTTP/1.1
Host: localhost:8092/
Accept: */*

OK

가상계좌 입금 확인 처리 (BO)

post

기능설명

BO에서 가상계좌 입금 확인 요청을 통해 주문/결제 상태를 업데이트합니다.

상세설명

• 자동 입금 노티 미수신 건에 대해 보조적으로 사용됩니다.

• 중복 요청 시 추가 처리는 수행되지 않습니다.

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

이니시스 가상계좌 입금 노티 요청

clientIpstringOptional

ip

systemTypestring · enumOptional

SYSTEM(시스템유형) * 10 : FO * 20 : BO

Default: 10Example: 10Possible values:

tidstringOptional

거래번호 (PC: no_tid, 모바일: P_TID)

ordNostringOptional

상점 주문번호 (PC: no_oid, 모바일: P_OID)

merchantIdstringOptional

상점 아이디 (PC: id_merchant, 모바일: P_MID)

transDatestringOptional

금융기관 발생 거래 일자 (PC: dt_trans, 모바일: P_AUTH_DT 앞 8자리)

transTimestringOptional

금융기관 발생 거래 시각 (PC: tm_trans, 모바일: P_AUTH_DT 뒤 6자리)

bankCodestringOptional

은행코드 (PC: cd_bank, 모바일: P_FN_CD1)

dealBankCodestringOptional

고객 실입금 시 은행코드 (PC만 해당)

vbankNostringOptional

가상계좌번호 (PC: no_vacct, 모바일: P_VACCT_NO)

inputAmountinteger · int64Optional

입금금액 (PC: amt_input, 모바일: P_AMT)

closeFlagstringOptional

마감구분 (PC만 해당)

closeCodestringOptional

마감구분코드 (PC만 해당)

msgTypestringOptional

거래구분 (PC: type_msg, 모바일: P_STATUS)

inputBankNamestringOptional

입금은행명 (PC: nm_inputbank, 모바일: P_FN_NM)

depositorNamestringOptional

입금자명 (PC: nm_input, 모바일: P_UNAME)

resultMsg1stringOptional

메시지1

resultMsg2stringOptional

메시지2

notiDatastringOptional

가맹점 임의 데이터

authNostringOptional

승인번호

payTypestringOptional

결제수단 (모바일: P_TYPE)

normalTransactionbooleanOptional

pcNotifybooleanOptional

mobileNotifybooleanOptional

Responses

200

성공

*/*

resultstringOptional

alreadyConfirmedbooleanOptional

900

업무처리 오류 내용

*/*

post

/v1/inicis/vbank/manualConfirm

HTTPcURLJavaScriptPython

POST /api/order/v1/inicis/vbank/manualConfirm HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 449

{
  "clientIp": "text",
  "systemType": "10",
  "tid": "text",
  "ordNo": "text",
  "merchantId": "text",
  "transDate": "text",
  "transTime": "text",
  "bankCode": "text",
  "dealBankCode": "text",
  "vbankNo": "text",
  "inputAmount": 1,
  "closeFlag": "text",
  "closeCode": "text",
  "msgType": "text",
  "inputBankName": "text",
  "depositorName": "text",
  "resultMsg1": "text",
  "resultMsg2": "text",
  "notiData": "text",
  "authNo": "text",
  "payType": "text",
  "normalTransaction": true,
  "pcNotify": true,
  "mobileNotify": true
}

{
  "result": "text",
  "mgrLog": {
    "siteNo": "text",
    "ordMgrLogSeq": "text",
    "logDt": "text",
    "logGbCd": "text",
    "ordNo": "text",
    "claimNo": "text",
    "mbrNo": "text",
    "procStatCd": "text",
    "reqHerJson": "text",
    "reqPrmtJson": "text",
    "rplyConts": "text",
    "errorConts": "text",
    "rmkConts": "text",
    "reqDtlJson": "text"
  },
  "targetInfo": {
    "ordNo": "text",
    "trdNo": "INIMX_CARDINIpayTest20990101090000685510",
    "trdDtm": "2026-02-27T18:08:22.305Z",
    "payFnshDtm": "2026-02-27T18:08:22.305Z",
    "mbrNo": "text",
    "ordManNm": "홍길동",
    "ordManCellNo": "text",
    "ordManEmailAddr": "[e-mail]",
    "ordGbCd": "10",
    "prstTypCd": "10",
    "prstMsg": "text",
    "ordGoodsGb": "10",
    "ordSeq": 1,
    "ordProcSeq": 1,
    "ordDtlStatCd": "10",
    "ecpnNo": "ORD0001",
    "payNo": "2",
    "payAmt": 1000,
    "dptFcstDt": "20990101",
    "dptCnfmDtm": "2026-02-27T18:08:22.305Z",
    "opOrdBase": {
      "siteNo": "text",
      "ordNo": "text",
      "ordMediaCd": "text",
      "ordGbCd": "text",
      "mbrNo": "text",
      "loginId": "text",
      "mbrMgrGbCd": "text",
      "ordManNm": "text",
      "ordAccpDtm": "2026-02-27T18:08:22.305Z",
      "mbrGradeCd": "text",
      "mbrMgrCd": "text",
      "fstOrdYn": "text",
      "umemPwd": "text",
      "ordManEmailAddr": "text",
      "ordManCellSctNo": "text",
      "ordManCellTxnoNo": "text",
      "ordManCellEndNo": "text",
      "ordManTelRgnNo": "text",
      "ordManTelTxnoNo": "text",
      "ordManTelEndNo": "text",
      "ordManZipNo": "text",
      "ordManZipAddr": "text",
      "ordManDtlAddr": "text",
      "rfdBankCd": "text",
      "rfdActnNo": "text",
      "rfdActnDepositorNm": "text",
      "prstTypCd": "text",
      "prstStatCd": "text",
      "prstMsg": "text",
      "prstRecvmnMbrNo": "text",
      "rglrDeliNo": "text",
      "chlNo": "text",
      "chlDtlNo": "text",
      "ordGoodsGb": "text"
    },
    "opOrdDtlList": [
      {
        "ordNo": "text",
        "ordSeq": 1,
        "ordProcSeq": 1,
        "uprOrdProcSeq": 1,
        "claimNo": "text",
        "goodsNo": "text",
        "itmNo": "text",
        "ordDtlGbCd": "text",
        "deliGbCd": "text",
        "ordAccpDtm": "2026-02-27T18:08:22.305Z",
        "ordFnshDtm": "2026-02-27T18:08:22.305Z",
        "ordDtlStatCd": "text",
        "ordQty": 1,
        "cnclQty": 1,
        "rtnQty": 1,
        "deliIndiDtm": "2026-02-27T18:08:22.305Z",
        "deliIndiRsvDtm": "2026-02-27T18:08:22.305Z",
        "deliNo": "text",
        "exchMidRtnYn": "text",
        "claimLgrpCd": "text",
        "claimMgrpCd": "text",
        "claimCausEtcCont": "text",
        "rtnPsbYn": "text",
        "exchPsbYn": "text",
        "ordCnclPsbYn": "text",
        "wthdYn": "text",
        "wthdFnshGbCd": "text",
        "shipFnshFcstDtm": "2026-02-27T18:08:22.305Z",
        "etcktNo": "text",
        "ecpnNo": "text"
      }
    ],
    "opOrdDtlGoodsInfoList": [
      {
        "ordNo": "text",
        "goodsNo": "text",
        "itmNo": "text",
        "ordSaleTypCd": "text",
        "chlNo": "text",
        "chlDtlNo": "text",
        "stdCtgNo": "text",
        "infDispCtgNoGbCd": "text",
        "infDispCtgNo": "text",
        "repDispCtgNo": "text",
        "conrNo": "text",
        "brandNo": "text",
        "brandNm": "text",
        "goodsNm": "text",
        "itmNm": "text",
        "prestNm": "text",
        "goodsCompCd": "text",
        "goodsTypCd": "text",
        "saleMethCd": "text",
        "taxGbCd": "text",
        "buyTypCd": "text",
        "supPcost": 1,
        "norPrc": 1,
        "salePrc": 1,
        "preSalePrc": 1,
        "mrgnRate": 1,
        "entrNo": "text",
        "deliPolcNo": "text",
        "deliDday": 1,
        "deliGoodsGbCd": "text",
        "deliWayCd": "text",
        "bpckPsbYn": "text",
        "rtnPsbYn": "text",
        "sngGoodsYn": "text",
        "hsCd": "text",
        "goodsRevWrtYn": "text",
        "exchPsbYn": "text",
        "entrGoodsNo": "text",
        "entrItmNo": "text",
        "ordCnclPsbYn": "text",
        "wthdYn": "text",
        "frgnDirPurGoodsYn": "text"
      }
    ],
    "ordDlvInfoList": [
      {
        "dlvpSeq": "1",
        "mbrDlvpSeq": "1",
        "baseDlvpYn": "Y",
        "dlvpNm": "우리집",
        "zipNo": "05837",
        "zipAddr": "서울 송파구 법원로9길",
        "dtlAddr": "에이치비지니스파크 D동 6층",
        "rcvmnNm": "홍길동",
        "rcvmnEmailAddr": "[e-mail]",
        "rcvmnCellSctNo": "010",
        "rcvmnCellTxnoNo": "0000",
        "rcvmnCellEndNo": "0000",
        "rcvmnTelRgnNo": "02",
        "rcvmnTelTxnoNo": "554",
        "rcvmnTelEndNo": "4583",
        "shopTrafMsg": "포장 안 해주셔도 돼요.",
        "deliMsgCd": "40",
        "deliMsg": "벨X, 노크X",
        "comnFrdrCogoMethodCd": "20",
        "comnFrdrEtcMethod": "뒷문 있어요.",
        "comnFrdrPwd": "123456",
        "pcccSeq": "text",
        "persCstmCd": "P100000000000",
        "newPersCstmCd": "P100000000000",
        "dlvGrpInfoList": [
          {
            "dlvpSeq": "1",
            "deliNo": "1",
            "deliKindCd": "10",
            "deliProcTypCd": "10",
            "deliMethodCd": "10",
            "basketGoodsList": [
              {
                "goodsNo": "100000001",
                "deliProcTypCd": "10",
                "deliPolcNo": "1",
                "deliNo": "100000021",
                "entrNo": "1000001",
                "ordQty": 1,
                "salePrc": 15000,
                "dcAmt": 3000,
                "sysModDtm": "2026-02-27T18:08:22.305Z",
                "itmNo": "001",
                "bsketNo": 100000001,
                "chlNo": "1",
                "chlDtlNo": "1",
                "infDispCtgNoGbCd": "01",
                "infDispCtgNo": "1",
                "repDispCtgNo": "1",
                "conrNo": "1",
                "bsketQty": 1,
                "goodsNm": "상품명",
                "stdCtgNo": "1",
                "goodsCompCd": "10",
                "goodsTypCd": "10",
                "saleMethCd": "10",
                "brandNo": "1",
                "brandNm": "브랜드명",
                "buyrAgeLmtCd": "0",
                "dispYn": "Y",
                "saleStatCd": "10",
                "saleStrDtm": "2026-02-27T18:08:22.305Z",
                "saleEndDtm": "2026-02-27T18:08:22.305Z",
                "buyTypCd": "10",
                "taxGbCd": "10",
                "stkMgrYn": "Y",
                "buyQtyLmtYn": "Y",
                "minLmtQty": 1,
                "maxLmtQty": 10,
                "safeStkNotiYn": "Y",
                "deliGoodsGbCd": "01",
                "deliWayCd": "01",
                "deliPsbRgnCd": "01",
                "deliDday": 1,
                "bpckPsbYn": "Y",
                "rtnPsbYn": "Y",
                "exchPsbYn": "Y",
                "supPcost": 10000,
                "norPrc": 20000,
                "preSalePrc": 20000,
                "mrgnRate": 4,
                "payMeanInfo": "11,12,32",
                "itmNm": "아이템명1>아이템명2>아이템명3",
                "stkQty": 999,
                "prestNm": "증정품명",
                "rsvStrtDtm": "2026-02-27T18:08:22.305Z",
                "rsvEndDtm": "2026-02-27T18:08:22.305Z",
                "fwdidcPrarDy": "2026-02-27",
                "hsCd": "1",
                "wishYn": "Y",
                "maxDcAmt": 1000,
                "goodsImg": "files/goods/2023/07/04/img",
                "itmSaleStatCd": "10",
                "gvgfPsbYn": "Y",
                "rglrDeliGoodsYn": "Y",
                "sngGoodsYn": "Y",
                "marketingDisplayNo": "1",
                "entrGoodsNo": "100042110583831",
                "entrItmNo": "100042110583831001",
                "ordCnclPsbYn": "N",
                "wthdYn": "N",
                "frgnDirPurGoodsYn": "text"
              }
            ],
            "dlvAmtInfoList": [
              {
                "ordCostGbCd": "10",
                "dlexTypCd": "10",
                "stdAdtnAmt": 20000,
                "dlexAmt": 3500,
                "aplyAdtnAmt": 20000,
                "trdTypCd": "text",
                "entrNo": "1000211",
                "deliPolcNo": "10000431",
                "dlvBenefitInfo": {
                  "promoNo": "C1000000",
                  "promoNm": "프로모션 명",
                  "promoTypCd": "11",
                  "ourChrgRate": 100,
                  "entrChrgRate": 0,
                  "cpnIsuNo": "100000",
                  "ordCostGbCd": "10"
                }
              }
            ]
          }
        ]
      }
    ],
    "opOrdPayBaseList": [
      {
        "payNo": "text",
        "ordNo": "text",
        "claimNo": "text",
        "uprPayNo": "text",
        "payGbCd": "text",
        "payWayCd": "text",
        "payStatCd": "text",
        "payAmt": 1,
        "rfdPsbAmt": 1,
        "payFnshDtm": "2026-02-27T18:08:22.305Z",
        "trdNo": "text",
        "trdDtm": "2026-02-27T18:08:22.305Z",
        "reqTrdNo": "text",
        "reqTrdDtm": "2026-02-27T18:08:22.305Z",
        "iscmCd": "text",
        "payReqCardcoCd": "text",
        "cardNo": "text",
        "cardNm": "text",
        "cardValiTerm": "text",
        "nintDivYn": "text",
        "divMonCnt": 1,
        "cardPointUseYn": "text",
        "mersNo": "text",
        "acqrCd": "text",
        "aprvNo": "text",
        "aprvDtm": "2026-02-27T18:08:22.305Z",
        "sctnCnclPsbYn": "text",
        "bankCd": "text",
        "actnNo": "text",
        "dpmnNm": "text",
        "dptFcstDt": "text",
        "dptCnfmDtm": "2026-02-27T18:08:22.305Z"
      }
    ],
    "opOrdAdtnCostList": [
      {
        "ordAdtnSn": "100001315",
        "ordNo": "20231231O000001",
        "claimNo": "20231231C000001",
        "deliNo": "100000001",
        "uprOrdAdtnSn": "100000842",
        "entrNo": "1000002",
        "adtnOcurGbCd": "10",
        "ordCostGbCd": "10",
        "stdAdtnAmt": 100000,
        "aplyAdtnAmt": 0,
        "cnclAdtnAmt": 0,
        "fvrAdtnAmt": 0,
        "deliPolcNo": "10000431",
        "dlexTypCd": "30",
        "dlexCnclCausCd": "10",
        "dlexAmt": 3000,
        "adtnBassNo": "C1001182",
        "adtnDtlBassNo": "105962",
        "fvrPolcTypCd": "00",
        "fvrPolcAplyVal": 0,
        "fvrMinBuyAmt": 0,
        "fvrMaxDcAmt": 0,
        "entrChrgRate": 0,
        "entrChrgAmt": 0,
        "ourChrgRate": 100,
        "ourChrgAmt": 0,
        "promoNm": "무료배송쿠폰"
      }
    ],
    "opOrdFvrCostList": [
      {
        "ordFvrCostSeq": "text",
        "ordNo": "text",
        "claimNo": "text",
        "uprOrdFvrCostSeq": "text",
        "adtnGbCd": "text",
        "adtnDtlGbCd": "text",
        "stdAdtnAmt": 1,
        "aplyAdtnAmt": 1,
        "cnclAdtnAmt": 1,
        "entrChrgRate": 1,
        "ourChrgRate": 1,
        "adtnBassNo": "text",
        "adtnDtlBassNo": "text",
        "fvrPolcTypCd": "text",
        "fvrPolcAplyVal": 1,
        "fvrMinBuyAmt": 1,
        "fvrMaxDcAmt": 1,
        "promoNm": "text"
      }
    ],
    "goodsDeliInfoList": [
      {
        "ordNo": "text",
        "ordSeq": 1,
        "ordProcSeq": 1,
        "goodsNo": "text",
        "itmNo": "text",
        "dlvpSeq": "1",
        "deliNo": "1",
        "deliKindCd": "10",
        "deliProcTypCd": "10",
        "deliMethodCd": "10"
      }
    ],
    "alreadyConfirmed": true
  },
  "alreadyConfirmed": true
}