헥토파이낸셜 개발자센터

010 Virtual Account Deposit Webhook

When a customer deposits to a 010 virtual account, Hecto Financial sends a deposit webhook to your server.

Webhook Overview

010 virtual account transactions deliver a total of two webhooks: an issuance webhook and a deposit webhook.

Webhook TypeoutStatCdbizTypeDescription
Issuance Webhook0051A4Delivered at the time of virtual account number issuance
Deposit Webhook0021B1Delivered at the time of customer deposit

Webhook Parameters (Hecto Financial → Merchant)

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└outStatCdAN(4)Alphanumeric, up to 4 bytes*0021
Transaction status
0021: Success (deposit complete) 0051: Virtual account awaiting deposit (issuance complete)
└trdNoAN(40)Alphanumeric, up to 40 bytes*STBK0123456789
Unique transaction number assigned by Hecto Financial
└methodA(2)Alphabetic, up to 2 bytes*VA
Payment method
VA: Virtual Account
└bizTypeAN(2)Alphanumeric, up to 2 bytes*B1
Business type
A4: Issuance A2: Issuance Cancel B1: Deposit Webhook C0: Refund
└mchtIdAN(10)Alphanumeric, up to 10 bytes*nxva_sb_il
Merchant ID
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytes*ORDER20211231100000
Merchant order number
└mchtCustNmAHN(30)Alphanumeric + Korean, up to 30 bytesHong Gil-dong
Customer name
└mchtNameAHN(20)Alphanumeric + Korean, up to 20 bytesHecto Financial
Merchant name (Korean)
└pmtprdNmAHN(128)Alphanumeric + Korean, up to 128 bytesTest Product
Product name
└trdDtmN(14)Numeric, up to 14 bytes*20211231010101
Transaction datetime (yyyyMMddHHmmss)
└trdAmtN(9)Numeric, up to 9 bytes1000
Transaction amount
└bankCdAN(10)Alphanumeric, up to 10 bytes089
Bank code
└bankNmAHN(10)Alphanumeric + Korean, up to 10 bytesKbank
Bank name
└vAcntNoN(64)Numeric, up to 64 bytes01012345678
Virtual account number
└expireDtN(14)Numeric, up to 14 bytes20211231235959
Virtual account deposit expiry datetime
└AcntPrintNmAHN(12)Alphanumeric + Korean, up to 12 bytes010가상계좌
Bank statement name
*B2C: fixed as '010가상계좌', B2B: '010_CustomerName'
└dpstrNmAHN(30)Alphanumeric + Korean, up to 30 bytesHong Gil-dong
Depositor name (name of the person who actually deposited)
└emailAN(60)Alphanumeric, up to 60 bytesHongGilDong@example.com
Customer email
└mchtCustIdAN(50)Alphanumeric, up to 50 bytesHongGilDong
Merchant customer ID
└orgTrdNoAN(40)Alphanumeric, up to 40 bytesSTBK0123456789
Original transaction number (for partial cancel)
└orgTrdDtN(8)Numeric, up to 8 bytes20211231
Original transaction date (for partial cancel)
└csrcIssNoN(9)Numeric, up to 9 bytes0123456789
Cash receipt approval number
└cnclTypeN(2)Numeric, up to 2 bytes00
Cancel transaction type
00: Full cancel 10: Partial cancel
└mchtParamAHN(4000)Alphanumeric + Korean, up to 4000 bytesMerchant reserved field
Merchant reserved field
└pktHashAN(64)Alphanumeric, up to 64 bytes*
SHA256 hash value
*Transaction status code + transaction date + transaction time + merchant ID + merchant order number + transaction amount + hash key

Webhook Response (Merchant → Hecto Financial)

The merchant sends the webhook receipt result to Hecto Financial.

ResponseDescription
OKSuccess (uppercase)
FAILFailure (uppercase) - recognized as explicit failure, webhook resent
OtherRecognized as abnormal failure; resent the configured number of times

Webhook Example

outStatCd=0021&trdNo=STBK0123456789&method=VA&bizType=B1&mchtId=nxva_sb_il&mchtTrdNo=ORDER20211231100000&mchtCustNm=Hong Gil-dong&mchtName=Hecto Financial&pmtprdNm=Test Product&trdDtm=20211231010101&trdAmt=1000&bankCd=089&bankNm=Kbank&vAcntNo=01012345678&expireDt=20211231235959&AcntPrintNm=010가상계좌&dpstrNm=Hong Gil-dong&mchtCustId=HongGilDong&pktHash=hash value

Important Notes

NOTE

Webhook Processing Recommendations

All payment-related DB processing must be handled in notiUrl. Use nextUrl only for screen display purposes.
  • Webhooks are delivered via POST to notiUrl.
  • If no response is received after webhook delivery, or if it is not FAIL, the webhook is resent.
  • The merchant server's firewall must allow Hecto Financial's webhook server IP.
💬

Need technical support?