Virtual Account
Function Description
Receives INICIS virtual account deposit notifications (PC/mobile integrated)
Detailed Description
Receives INICIS virtual account deposit notifications and updates the order information.
Upon successful order information update, issues a cash receipt and sends an order completion notification message.
Query parameters
Header parameters
AuthorizationanyOptional
Access Token
Responses
200
Success
text/plain
stringOptionalExample:
OK900
Failure
text/plain
post/v1/payment/vbank/noti
POST /api/order/v1/payment/vbank/noti?params=[object+Object] HTTP/1.1
Host: api-order.x2bee.com/
Accept: */*
OKHeader parameters
AuthorizationanyOptional
Access Token
Body
INICIS Virtual Account Deposit Notification Request
clientIpstringOptional
ip
systemTypestring · enumOptionalDefault:
SYSTEM (System Type) * 10 : FO * 20 : BO
10Example: 10Possible values: tidstringOptional
Transaction No. (PC: no_tid, Mobile: P_TID)
ordNostringOptional
Store Order No. (PC: no_oid, Mobile: P_OID)
merchantIdstringOptional
Store ID (PC: id_merchant, Mobile: P_MID)
transDatestringOptional
Financial Institution Transaction Date (PC: dt_trans, Mobile: first 8 digits of P_AUTH_DT)
transTimestringOptional
Financial Institution Transaction Time (PC: tm_trans, Mobile: last 6 digits of P_AUTH_DT)
bankCodestringOptional
Bank Code (PC: cd_bank, Mobile: P_FN_CD1)
dealBankCodestringOptional
Bank Code Used at Customer's Actual Deposit (PC only)
vbankNostringOptional
Virtual Account No. (PC: no_vacct, Mobile: P_VACCT_NO)
inputAmountinteger · int64Optional
Deposit Amount (PC: amt_input, Mobile: P_AMT)
closeFlagstringOptional
Closing Type (PC only)
closeCodestringOptional
Closing Type Code (PC only)
msgTypestringOptional
Transaction Type (PC: type_msg, Mobile: P_STATUS)
inputBankNamestringOptional
Depositing Bank Name (PC: nm_inputbank, Mobile: P_FN_NM)
depositorNamestringOptional
Depositor Name (PC: nm_input, Mobile: P_UNAME)
resultMsg1stringOptional
Message 1
resultMsg2stringOptional
Message 2
notiDatastringOptional
Merchant Custom Data
authNostringOptional
Approval No.
payTypestringOptional
Payment Method (Mobile: P_TYPE)
normalTransactionbooleanOptional
mobileNotifybooleanOptional
pcNotifybooleanOptional
Responses
200
Success
*/*
resultstringOptional
alreadyConfirmedbooleanOptional
900
Business processing error details
*/*
post/v1/payment/vbank/manualConfirm
POST /api/order/v1/payment/vbank/manualConfirm HTTP/1.1
Host: api-order.x2bee.com/
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,
"mobileNotify": true,
"pcNotify": 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-01-01T00:00:00.000Z",
"payFnshDtm": "2026-01-01T00:00:00.000Z",
"mbrNo": "text",
"ordManNm": "홍길동",
"ordManCellNo": "text",
"ordManEmailAddr": "test@plateer.com",
"ordGbCd": "10",
"prstTypCd": "10",
"prstMsg": "text",
"ordGoodsGb": "10",
"ordSeq": 1,
"ordProcSeq": 1,
"ordDtlStatCd": "10",
"ecpnNo": "ORD0001",
"payNo": "2",
"payAmt": 1000,
"dptFcstDt": "20990101",
"dptCnfmDtm": "2026-01-01T00:00:00.000Z",
"opOrdBase": {
"siteNo": "text",
"ordNo": "text",
"ordMediaCd": "text",
"ordGbCd": "text",
"mbrNo": "text",
"loginId": "text",
"mbrMgrGbCd": "text",
"ordManNm": "text",
"ordAccpDtm": "2026-01-01T00:00:00.000Z",
"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-01-01T00:00:00.000Z",
"ordFnshDtm": "2026-01-01T00:00:00.000Z",
"ordDtlStatCd": "text",
"ordQty": 1,
"cnclQty": 1,
"rtnQty": 1,
"deliIndiDtm": "2026-01-01T00:00:00.000Z",
"deliIndiRsvDtm": "2026-01-01T00:00:00.000Z",
"deliNo": "text",
"exchMidRtnYn": "text",
"claimLgrpCd": "text",
"claimMgrpCd": "text",
"claimCausEtcCont": "text",
"rtnPsbYn": "text",
"exchPsbYn": "text",
"ordCnclPsbYn": "text",
"wthdYn": "text",
"wthdFnshGbCd": "text",
"shipFnshFcstDtm": "2026-01-01T00:00:00.000Z",
"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": 5837,
"zipAddr": "서울 송파구 법원로9길",
"dtlAddr": "에이치비지니스파크 D동 6층",
"rcvmnNm": "홍길동",
"rcvmnEmailAddr": "receiver@plateer.com",
"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-01-01T00:00:00.000Z",
"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-01-01T00:00:00.000Z",
"saleEndDtm": "2026-01-01T00:00:00.000Z",
"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-01-01T00:00:00.000Z",
"rsvEndDtm": "2026-01-01T00:00:00.000Z",
"fwdidcPrarDy": "2026-01-01",
"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-01-01T00:00:00.000Z",
"trdNo": "text",
"trdDtm": "2026-01-01T00:00:00.000Z",
"reqTrdNo": "text",
"reqTrdDtm": "2026-01-01T00:00:00.000Z",
"iscmCd": "text",
"payReqCardcoCd": "text",
"cardNo": "text",
"cardNm": "text",
"cardValiTerm": "text",
"nintDivYn": "text",
"divMonCnt": 1,
"cardPointUseYn": "text",
"mersNo": "text",
"acqrCd": "text",
"aprvNo": "text",
"aprvDtm": "2026-01-01T00:00:00.000Z",
"sctnCnclPsbYn": "text",
"bankCd": "text",
"actnNo": "text",
"dpmnNm": "text",
"dptFcstDt": "text",
"dptCnfmDtm": "2026-01-01T00:00:00.000Z"
}
],
"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
}Last updated