헥토파이낸셜 개발자센터
ProductsProducts
Payment Gateway
Cards, bank & digital wallets
My Bank Pay
Open banking debit
Easy Cash Payment
Stored-account payments
White-Label Payments
White-label checkout
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Integrate with LLMs
MCP server & AI chatbot
API & SDKAPI & SDK
Payment Gateway
Cards, bank & digital wallets
My Bank Pay
Open banking debit
Easy Cash Payment
Stored-account payments
White-Label Payments
White-label checkout
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
블로그Blog
Service Status
Payment Gateway
My Bank Pay
Easy Cash Payment
White-Label Payments
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Integrate with LLMs
MCP 서버 및 AI 챗봇
Payment Gateway
My Bank Pay
Easy Cash Payment
White-Label Payments
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Blog
Technical blog & news
Service Status
Incidents and scheduled maintenance
Payment Gateway
Before You BeginServers & NetworkIntegration OverviewWebhooksCancellations & RefundsGo Live
Checkout IntegrationJavaScript SDKForm-Based Checkout Integration
Credit Card CheckoutCredit Card Direct APICredit Card WebhookCredit Card Deferred CaptureRegister Card (Billkey Checkout)Charge with Payment TokenDelete Payment TokenCancel Charge
Bank Transfer CheckoutBank Transfer WebhookBank Transfer Deferred CaptureCancel Bank Transfer
Virtual Account CheckoutVirtual Account Deposit WebhookIssue Virtual AccountFixed/Unlimited Virtual AccountModify Virtual AccountCancel Virtual AccountDeposit LookupRefund Virtual AccountSimulate Deposit
010 Virtual Account Overview010 Virtual Account CheckoutPhone Ownership Verification — RequestPhone Ownership Verification — ConfirmDuplicate Amount CheckIssue 010 Virtual AccountCancel 010 Virtual AccountRefund 010 Virtual Account010 Virtual Account Deposit WebhookSimulate 010 Deposit
Mobile Payment CheckoutMobile Payment WebhookMobile Payment — Two-Step CaptureMobile Recurring PaymentCancel Mobile PaymentRefund Mobile Payment
Gift Card CheckoutGift Card WebhookCancel Gift Card Payment
T-money CheckoutT-money WebhookCancel T-money Payment
Point Damoa CheckoutPoint Damoa WebhookPoint Damoa Deferred CaptureCancel Point Damoa Payment
Digital Wallets OverviewPAYCO CheckoutPAYCO SandboxSamsung Pay CheckoutKakaoPay CheckoutNaverPay CheckoutTossPay CheckoutDigital Wallet WebhookCancel Digital Wallet PaymentWallet Recurring PaymentSubscription StatusCancel Subscription
Real-time Transaction LookupReceipt (Sales Slip) Inquiry (No Auth)Receipt (Sales Slip) Inquiry (Auth)Transaction ReconciliationSettlement ReconciliationSub-Merchant RegistrationPreferential Settlement (SME)SME Refund Adjustment
Error CodesCard Issuer CodesBank CodesPayment Method CodesVirtual Account Bank Codes
My Bank Pay
Before You BeginServers & NetworkIntegration Overview
Checkout SDK
My Bank Pay — AuthenticateMy Bank Pay — CaptureMy Bank Pay — CancelMy Bank Pay — Network Cancel
Transaction Result LookupTransaction HistoryCash Receipt Lookup
Create Recurring TokenCharge via Recurring TokenCancel Subscription
Error CodesBank CodesBank Maintenance Schedule
Easy Cash Payment
Before You BeginServers & NetworkFirm Banking Integration Flow
Mobile Identity Verification — RequestMobile Identity Verification — ConfirmAccount Holder Name Lookup IAccount Holder Name Lookup IIAccount Holder Name (with Amount)Account Ownership VerificationAccount Ownership — RequestAccount Ownership — ConfirmIVR Verification — RequestIVR Verification — ConfirmOwnership Verification HistoryPayment PIN Verification
Register AccountDeregister AccountSelf-Service Account RegistrationKFTC Deregistered Account Lookup
Capture PaymentCancel / Refund PaymentSend RemittanceRemittance Account Balance
Create Recurring TokenCharge via Recurring TokenCancel SubscriptionSubscription DetailsSubscription History
Transaction Result LookupTransaction HistoryAccount ListSupported BanksBank Maintenance CheckOwnership Verification Bank MaintenanceConnectivity Test
Before You BeginServers & NetworkOpen Banking Integration Flow
Register AccountRegister Open Banking AccountDeregister Open Banking Service
Capture PaymentCancel PaymentSend Remittance
Submit Refund ClaimRefund Claim Status
Transaction Result LookupTransaction HistoryAccount ListWithdrawal Limit
Decline Code ReferenceBank Code ReferenceBank Maintenance Schedule
White-Label Payments
Before You BeginServers & NetworkIntegration Overview
Payment CheckoutCapture PaymentCancellations & Refunds
Inquiry
Error CodesBank CodesBank Maintenance Schedule
Cash Receipt
Before You BeginServers & NetworkIntegration Overview
Issue Cash ReceiptCancel Cash Receipt
Issuance Error LookupIssuance Status Lookup
Reprocessing RegistrationReprocessing Result Lookup
Reference
Firm Banking
Before You BeginIntegration Overview
Connection Management
Interbank TransferCollection TransferCollection Account SetupReserve Transfer (SC Bank)Trust Deposit (Woori Bank)
Transfer Failure WebhookTransaction Statement WebhookBill Statement WebhookBill Statement — Missing SequenceReserve Transfer Result Webhook (SC)Transfer Failure — Missing SequenceTransaction Detail — Missing Sequence
Account Holder Name LookupTransfer Result LookupBalance LookupReserve Transfer Result (SC)Auto Transfer Result (SC)
Transfer ReconciliationCollection ReconciliationWebhook Delivery Status
Connection Management
FX RemittanceCancel FX RemittanceFX Remittance Result WebhookFX Remittance Result — Missing SequenceFX Remittance (MX)FX Remittance Result Webhook (MX)FX Remittance — Missing Sequence (MX)
FX Same-Bank Holder LookupFX Account Holder LookupExchange Rate LookupExchange Rate Lookup (KEB)FX Remittance Result LookupFX Balance Lookup
FX Remittance ReconciliationFX Auto Transfer ReconciliationFX Same-Bank Remittance Reconciliation
FX Transaction Statement WebhookFX Transaction Statement — Missing Sequence
VAN Virtual Account
Getting Started with VAVSCommunication and Message FormatCommon Header
Recipient InquiryDeposit and Cancellation
RemittanceDeposit Balance Inquiry
Reconciliation
Account Holder InquiryActual Depositor NotificationActual Depositor FileMissing Actual Depositor InquiryWithdrawal Account Registration
Bank CodesResponse CodesChannel CodesBank Operating Hours
Prepaid Wallet
Before You BeginServers & NetworkIntegration Overview
Member Registration UIMy Account UI
Spend BalanceVoid SpendSend Money GiftRevoke Points
Balance LookupBalance OptionsBalance DetailsBalance by Top-upWithdrawable BalanceTransaction ListTransaction DetailsTransaction Details by StoreMember DetailsExpiring PointsTop-up Methods
Top-upCancel Top-upWithdraw FundsPending Withdrawal
Error CodesTransaction Type Codes

Tools

Encryption Test
Payment Gateway
Before You BeginServers & NetworkIntegration OverviewWebhooksCancellations & RefundsGo Live
Checkout IntegrationJavaScript SDKForm-Based Checkout Integration
Credit Card CheckoutCredit Card Direct APICredit Card WebhookCredit Card Deferred CaptureRegister Card (Billkey Checkout)Charge with Payment TokenDelete Payment TokenCancel Charge
Bank Transfer CheckoutBank Transfer WebhookBank Transfer Deferred CaptureCancel Bank Transfer
Virtual Account CheckoutVirtual Account Deposit WebhookIssue Virtual AccountFixed/Unlimited Virtual AccountModify Virtual AccountCancel Virtual AccountDeposit LookupRefund Virtual AccountSimulate Deposit
010 Virtual Account Overview010 Virtual Account CheckoutPhone Ownership Verification — RequestPhone Ownership Verification — ConfirmDuplicate Amount CheckIssue 010 Virtual AccountCancel 010 Virtual AccountRefund 010 Virtual Account010 Virtual Account Deposit WebhookSimulate 010 Deposit
Mobile Payment CheckoutMobile Payment WebhookMobile Payment — Two-Step CaptureMobile Recurring PaymentCancel Mobile PaymentRefund Mobile Payment
Gift Card CheckoutGift Card WebhookCancel Gift Card Payment
T-money CheckoutT-money WebhookCancel T-money Payment
Point Damoa CheckoutPoint Damoa WebhookPoint Damoa Deferred CaptureCancel Point Damoa Payment
Digital Wallets OverviewPAYCO CheckoutPAYCO SandboxSamsung Pay CheckoutKakaoPay CheckoutNaverPay CheckoutTossPay CheckoutDigital Wallet WebhookCancel Digital Wallet PaymentWallet Recurring PaymentSubscription StatusCancel Subscription
Real-time Transaction LookupReceipt (Sales Slip) Inquiry (No Auth)Receipt (Sales Slip) Inquiry (Auth)Transaction ReconciliationSettlement ReconciliationSub-Merchant RegistrationPreferential Settlement (SME)SME Refund Adjustment
Error CodesCard Issuer CodesBank CodesPayment Method CodesVirtual Account Bank Codes
My Bank Pay
Before You BeginServers & NetworkIntegration Overview
Checkout SDK
My Bank Pay — AuthenticateMy Bank Pay — CaptureMy Bank Pay — CancelMy Bank Pay — Network Cancel
Transaction Result LookupTransaction HistoryCash Receipt Lookup
Create Recurring TokenCharge via Recurring TokenCancel Subscription
Error CodesBank CodesBank Maintenance Schedule
Easy Cash Payment
Before You BeginServers & NetworkFirm Banking Integration Flow
Mobile Identity Verification — RequestMobile Identity Verification — ConfirmAccount Holder Name Lookup IAccount Holder Name Lookup IIAccount Holder Name (with Amount)Account Ownership VerificationAccount Ownership — RequestAccount Ownership — ConfirmIVR Verification — RequestIVR Verification — ConfirmOwnership Verification HistoryPayment PIN Verification
Register AccountDeregister AccountSelf-Service Account RegistrationKFTC Deregistered Account Lookup
Capture PaymentCancel / Refund PaymentSend RemittanceRemittance Account Balance
Create Recurring TokenCharge via Recurring TokenCancel SubscriptionSubscription DetailsSubscription History
Transaction Result LookupTransaction HistoryAccount ListSupported BanksBank Maintenance CheckOwnership Verification Bank MaintenanceConnectivity Test
Before You BeginServers & NetworkOpen Banking Integration Flow
Register AccountRegister Open Banking AccountDeregister Open Banking Service
Capture PaymentCancel PaymentSend Remittance
Submit Refund ClaimRefund Claim Status
Transaction Result LookupTransaction HistoryAccount ListWithdrawal Limit
Decline Code ReferenceBank Code ReferenceBank Maintenance Schedule
White-Label Payments
Before You BeginServers & NetworkIntegration Overview
Payment CheckoutCapture PaymentCancellations & Refunds
Inquiry
Error CodesBank CodesBank Maintenance Schedule
Cash Receipt
Before You BeginServers & NetworkIntegration Overview
Issue Cash ReceiptCancel Cash Receipt
Issuance Error LookupIssuance Status Lookup
Reprocessing RegistrationReprocessing Result Lookup
Reference
Firm Banking
Before You BeginIntegration Overview
Connection Management
Interbank TransferCollection TransferCollection Account SetupReserve Transfer (SC Bank)Trust Deposit (Woori Bank)
Transfer Failure WebhookTransaction Statement WebhookBill Statement WebhookBill Statement — Missing SequenceReserve Transfer Result Webhook (SC)Transfer Failure — Missing SequenceTransaction Detail — Missing Sequence
Account Holder Name LookupTransfer Result LookupBalance LookupReserve Transfer Result (SC)Auto Transfer Result (SC)
Transfer ReconciliationCollection ReconciliationWebhook Delivery Status
Connection Management
FX RemittanceCancel FX RemittanceFX Remittance Result WebhookFX Remittance Result — Missing SequenceFX Remittance (MX)FX Remittance Result Webhook (MX)FX Remittance — Missing Sequence (MX)
FX Same-Bank Holder LookupFX Account Holder LookupExchange Rate LookupExchange Rate Lookup (KEB)FX Remittance Result LookupFX Balance Lookup
FX Remittance ReconciliationFX Auto Transfer ReconciliationFX Same-Bank Remittance Reconciliation
FX Transaction Statement WebhookFX Transaction Statement — Missing Sequence
VAN Virtual Account
Getting Started with VAVSCommunication and Message FormatCommon Header
Recipient InquiryDeposit and Cancellation
RemittanceDeposit Balance Inquiry
Reconciliation
Account Holder InquiryActual Depositor NotificationActual Depositor FileMissing Actual Depositor InquiryWithdrawal Account Registration
Bank CodesResponse CodesChannel CodesBank Operating Hours
Prepaid Wallet
Before You BeginServers & NetworkIntegration Overview
Member Registration UIMy Account UI
Spend BalanceVoid SpendSend Money GiftRevoke Points
Balance LookupBalance OptionsBalance DetailsBalance by Top-upWithdrawable BalanceTransaction ListTransaction DetailsTransaction Details by StoreMember DetailsExpiring PointsTop-up Methods
Top-upCancel Top-upWithdraw FundsPending Withdrawal
Error CodesTransaction Type Codes

Tools

Encryption Test

Digital Wallet Webhook

When a transaction is successfully completed, Hecto Financial sends a webhook to your server. For details, see the notiUrl guide.

This document applies to webhooks for the following digital wallet payment methods:

Digital WalletCodeWebhook Doc
KakaoPayKKPThis document
NaverPayNVPThis document
PAYCOPACThis document
TossPayTOSThis document
Samsung PaySPPCredit Card Webhook
NOTE

What is notiUrl?

notiUrl is a server-to-server webhook that delivers the payment result directly from the Hecto Financial server to your server. It does not go through the browser, allowing stable receipt of results.

Communication Specification

ItemDescription
MethodPOST
Content-Typeapplication/x-www-form-urlencoded; charset=UTF-8
Response FormatPlain Text (OK or FAIL)

Cancellation Webhook Notice

Cancellation webhook is not provided by default

Digital wallet cancellation results are confirmed via API response, so cancellation webhooks are not sent by default. If you need cancellation webhooks, contact your sales representative or technical support (pgsupport@hecto.co.kr).

Webhook Parameters

Type Notation
NNumericAAlphabeticHKoreanANAlphanumericAHNAlphanumeric + Korean
e.g. AN(10) = alphanumeric, up to 10 bytes
└outStatCdAN(4)Alphanumeric, up to 4 bytes*Transaction status0021
Transaction status
0021: Success
Parameter
Type
Description
Example
outStatCdRequired
AN(4)
Transaction status
0021: Success
0021
└trdNoAN(40)Alphanumeric, up to 40 bytes*Unique transaction number assigned by Hecto FinancialSTFP_PGPZhecto_test0211129135810M1494620
Unique transaction number assigned by Hecto Financial
Parameter
Type
Description
Example
trdNoRequired
AN(40)
Unique transaction number assigned by Hecto Financial
STFP_PGPZhecto_test0211129135810M1494620
└methodA(2)Alphabetic, up to 2 bytes*Payment methodPZ
Payment method
PZ: Digital Wallet
Parameter
Type
Description
Example
methodRequired
A(2)
Payment method
PZ: Digital Wallet
PZ
└bizTypeAN(2)Alphanumeric, up to 2 bytes*Business typeB0
Business type
B0: Approval (KakaoPay, PAYCO, Toss Pay, and Naver Pay points/money) B1: Approval (Naver Pay card only) B3: Recurring payment approval C0: Cancellation (not provided by default; available on request)
Parameter
Type
Description
Example
bizTypeRequired
AN(2)
Business type
B0: Approval (KakaoPay, PAYCO, Toss Pay, and Naver Pay points/money) / B1: Approval (Naver Pay card only) / B3: Recurring payment approval / C0: Cancellation (not provided by default; available on request)
B0
└mchtIdAN(10)Alphanumeric, up to 10 bytes*Merchant ID assigned by Hecto Financialhecto_test
Merchant ID assigned by Hecto Financial
Parameter
Type
Description
Example
mchtIdRequired
AN(10)
Merchant ID assigned by Hecto Financial
hecto_test
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytes*Unique order number generated by the merchantORDER20211231100000
Unique order number generated by the merchant
Parameter
Type
Description
Example
mchtTrdNoRequired
AN(100)
Unique order number generated by the merchant
ORDER20211231100000
└ezpDivCdA(3)Alphabetic, up to 3 bytes*Digital wallet provider classification codeKKP
Digital wallet provider classification code
KKP: KakaoPay NVP: NaverPay PAC: PAYCO TOS: TossPay
Parameter
Type
Description
Example
ezpDivCdRequired
A(3)
Digital wallet provider classification code
KKP: KakaoPay / NVP: NaverPay / PAC: PAYCO / TOS: TossPay
KKP
└mchtNameAHN(20)Alphanumeric + Korean, up to 20 bytesMerchant nameHecto Financial
Merchant name
Parameter
Type
Description
Example
mchtName
AHN(20)
Merchant name
Hecto Financial
└pmtprdNmAHN(128)Alphanumeric + Korean, up to 128 bytesProduct name ordered by the customerTest Product
Product name ordered by the customer
Parameter
Type
Description
Example
pmtprdNm
AHN(128)
Product name ordered by the customer
Test Product
└trdDtmN(14)Numeric, up to 14 bytes*Transaction datetime. Format: YYYYMMDDhhmmss20211231100000
Transaction datetime. Format: YYYYMMDDhhmmss
Parameter
Type
Description
Example
trdDtmRequired
N(14)
Transaction datetime. Format: YYYYMMDDhhmmss
20211231100000
└trdAmtN(12)Numeric, up to 12 bytesTransaction amount1000
Transaction amount
Parameter
Type
Description
Example
trdAmt
N(12)
Transaction amount
1000
└cardCdAN(10)Alphanumeric, up to 10 bytesCard company code (for card payment)NHC
Card company code (for card payment)
Parameter
Type
Description
Example
cardCd
AN(10)
Card company code (for card payment)
NHC
└cardNmAHN(20)Alphanumeric + Korean, up to 20 bytesCard company nameNH Check
Card company name
Parameter
Type
Description
Example
cardNm
AHN(20)
Card company name
NH Check
└emailAN(60)Alphanumeric, up to 60 bytesMerchant customer emailHongGilDong@example.com
Merchant customer email
Parameter
Type
Description
Example
email
AN(60)
Merchant customer email
HongGilDong@example.com
└mchtCustIdAN(50)Alphanumeric, up to 50 bytesMerchant customer IDHongGilDong
Merchant customer ID
Parameter
Type
Description
Example
mchtCustId
AN(50)
Merchant customer ID
HongGilDong
└cardNoAN(20)Alphanumeric, up to 20 bytesMasked card number123456******7890
Masked card number
*For KakaoPay, only the BIN number is provided.
For NaverPay, the approval may use an OTC (One Time Card, one-time card number), which may differ from the actual card number.
Parameter
Type
Description
Example
cardNo
AN(20)
Masked card number
* For KakaoPay, only the BIN number is provided. For NaverPay, the approval may use an OTC (One Time Card, one-time card number), which may differ from the actual card number.
123456******7890
└cardApprNoAN(15)Alphanumeric, up to 15 bytesCard approval number30001234
Card approval number
Parameter
Type
Description
Example
cardApprNo
AN(15)
Card approval number
30001234
└instmtMonN(2)Numeric, up to 2 bytesInstallment months00
Installment months
Parameter
Type
Description
Example
instmtMon
N(2)
Installment months
00
└instmtTypeA(1)Alphabetic, up to 1 bytesY if the installment month is part of a card company event (optional based on merchant settings)N
Y if the installment month is part of a card company event (optional based on merchant settings)
Parameter
Type
Description
Example
instmtType
A(1)
Y if the installment month is part of a card company event (optional based on merchant settings)
N
└orgTrdNoAN(40)Alphanumeric, up to 40 bytesOriginal transaction number for cancellationsSTFP_PGPZhecto_test0211129135810M1494620
Original transaction number for cancellations
Parameter
Type
Description
Example
orgTrdNo
AN(40)
Original transaction number for cancellations
STFP_PGPZhecto_test0211129135810M1494620
└orgTrdDtN(8)Numeric, up to 8 bytesOriginal transaction date for cancellations20211231
Original transaction date for cancellations
Parameter
Type
Description
Example
orgTrdDt
N(8)
Original transaction date for cancellations
20211231
└pntAmtN(13)Numeric, up to 13 bytes*Points/Money payment amount out of the total0
Points/Money payment amount out of the total
*For NaverPay, points and money are combined and provided as a single total
Parameter
Type
Description
Example
pntAmtRequired
N(13)
Points/Money payment amount out of the total
* For NaverPay, points and money are combined and provided as a single total
0
└cardAmtN(13)Numeric, up to 13 bytes*Credit card amount out of the total3000
Credit card amount out of the total
Parameter
Type
Description
Example
cardAmtRequired
N(13)
Credit card amount out of the total
3000
└coupAmtN(13)Numeric, up to 13 bytes*Coupon amount out of the total1000
Coupon amount out of the total
Parameter
Type
Description
Example
coupAmtRequired
N(13)
Coupon amount out of the total
1000
└kkmAmtN(13)Numeric, up to 13 bytesKakao Money amount5000
Kakao Money amount
Parameter
Type
Description
Example
kkmAmt
N(13)
Kakao Money amount
5000
└mnyAmtN(13)Numeric, up to 13 bytesTossPay Money amount5000
TossPay Money amount
*For TossPay (TOS) payments, the amount paid with TossPay Money out of the total
Parameter
Type
Description
Example
mnyAmt
N(13)
TossPay Money amount
* For TossPay (TOS) payments, the amount paid with TossPay Money out of the total
5000
└csrcIssAmtN(13)Numeric, up to 13 bytesCash receipt issuance eligible amount3000
Cash receipt issuance eligible amount
*Delivered only for NaverPay payments. For simple payments other than NaverPay (KakaoPay, PAYCO, TossPay, etc.), the cash receipt is handled directly by each provider, so this parameter is not delivered.
For NaverPay, complimentary points (issued via events/promotions) are excluded from the point/money payment amount.
Parameter
Type
Description
Example
csrcIssAmt
N(13)
Cash receipt issuance eligible amount
* Delivered only for NaverPay payments. For simple payments other than NaverPay (KakaoPay, PAYCO, TossPay, etc.), the cash receipt is handled directly by each provider, so this parameter is not delivered. For NaverPay, complimentary points (issued via events/promotions) are excluded from the point/money payment amount.
3000
└cnclTypeN(2)Numeric, up to 2 bytesCancellation transaction type00
Cancellation transaction type
00: Full cancellation 10: Partial cancellation
Parameter
Type
Description
Example
cnclType
N(2)
Cancellation transaction type
00: Full cancellation / 10: Partial cancellation
00
└csrcIssNoAN(30)Alphanumeric, up to 30 bytesCash receipt approval number0123456789
Cash receipt approval number
*Delivered only for NaverPay payments. For simple payments other than NaverPay (KakaoPay, PAYCO, TossPay, etc.), the cash receipt is handled directly by each provider, so this parameter is not delivered.
Parameter
Type
Description
Example
csrcIssNo
AN(30)
Cash receipt approval number
* Delivered only for NaverPay payments. For simple payments other than NaverPay (KakaoPay, PAYCO, TossPay, etc.), the cash receipt is handled directly by each provider, so this parameter is not delivered.
0123456789
└billKeyAN(40)Alphanumeric, up to 40 bytesSubscription Key or sequential payment key (issued for subscription/sequential payment)SBILL_0123456789
Subscription Key or sequential payment key (issued for subscription/sequential payment)
*Requires separate application through a sales representative.
Parameter
Type
Description
Example
billKey
AN(40)
Subscription Key or sequential payment key (issued for subscription/sequential payment)
* Requires separate application through a sales representative.
SBILL_0123456789
└mchtParamAHN(4000)Alphanumeric + Korean, up to 4000 bytesAdditional merchant information field. The value passed in the request is returned as-is.name=HongGilDong&age=25
Additional merchant information field. The value passed in the request is returned as-is.
Parameter
Type
Description
Example
mchtParam
AHN(4000)
Additional merchant information field. The value passed in the request is returned as-is.
name=HongGilDong&age=25
└pktHashAN(64)Alphanumeric, up to 64 bytes*SHA256 hash valuea2d6d597d55d7c9b689baa2e08c1ddf0ce71f4248c5b9b59fe61bfbf949543e1
SHA256 hash value
Parameter
Type
Description
Example
pktHashRequired
AN(64)
SHA256 hash value
a2d6d597d55d7c9b689baa2e08c1ddf0ce71f4248c5b9b59fe61bfbf949543e1
NOTE

Hash generation combination

outStatCd + transaction date (first 8 digits of trdDtm) + transaction time (last 6 digits of trdDtm) + mchtId + mchtTrdNo + trdAmt (plaintext) + hashKey

Webhook Response (Merchant → Hecto Financial)

Your server sends a response back to Hecto Financial.

ResponseDescription
OKSuccess (uppercase). Processed as webhook received.
FAIL or othersRecognized as failure; resent up to the configured number of times per merchant. Sending stops after exceeding the resend deadline.

Response format note

The response must be plain text 'OK' only. If spaces or other characters are included, it will be considered a failure and resending will occur.

Hash Verification

Hash verification required

To check for data tampering, you must verify the hash data received via notiUrl. Only provide the service when the hash matches.
ItemCombination Fields
pktHashoutStatCd + transaction date (first 8 digits of trdDtm) + transaction time (last 6 digits of trdDtm) + mchtId + mchtTrdNo + trdAmt (plaintext) + hashKey

Webhook Example

Payment Webhook (Hecto Financial → Merchant)

POST /your-noti-url HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=UTF-8

outStatCd=0021
&trdNo=STFP_PGPZhecto_test0211231100000M1234567
&method=PZ
&bizType=B0
&mchtId=hecto_test
&mchtTrdNo=ORDER20211231100000
&ezpDivCd=KKP
&mchtName=HectoFinancial
&pmtprdNm=Test Product
&trdDtm=20211231100000
&trdAmt=50000
&cardCd=NHC
&cardNm=NH Check
&cardNo=123456******7890
&cardApprNo=30001234
&instmtMon=00
&pntAmt=0
&cardAmt=50000
&coupAmt=0
&email=test@example.com
&mchtCustId=customer123
&billKey=SBILL_0123456789
&mchtParam=
&pktHash=a2d6d597d55d7c9b689baa2e08c1ddf0ce71f4248c5b9b59fe61bfbf949543e1

Response (Merchant → Hecto Financial)

OK
💬

Need technical support?

Code Samples

HectoFinancial GitHub