헥토파이낸셜 개발자센터
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

Mobile Payment Hybrid Capture API

The Hybrid Capture method performs authentication only in the checkout, while the capture is requested separately from the merchant server. Authentication and capture can be processed independently.

Test Key Information

Encryption Key: pgSettle30y739r82jtd709yOfZ2yK5K
Hash Key: ST1009281328226982205
* Production credentials are provided by Hecto Financial upon contract completion.

API Information

POST/spay/APIService.do
Content-Typeapplication/json
Sandboxhttps://tbgw.settlebank.co.kr/spay/APIService.do
Productionhttps://gw.settlebank.co.kr/spay/APIService.do

Important Notes

NOTE

Hybrid Capture Flow

1) Authentication request in the checkout (linkMethod='HBRD') → 2) Authentication success response (outStatCd='0061') → 3) Capture request using this API
  • Set the linkMethod parameter to HBRD when making the checkout request.
  • On authentication success, outStatCd returns 0061.
  • Use the trdNo returned upon authentication success as authTrdNo when requesting capture.
  • The merchant order number (mchtTrdNo) must be the same value used in the authentication request.

Request Parameters

Type Notation
NNumericAAlphabeticHKoreanANAlphanumericAHNAlphanumeric + Korean
e.g. AN(10) = alphanumeric, up to 10 bytes

params Object

└mchtIdAN(10)Alphanumeric, up to 10 bytes*Unique merchant ID assigned by Hecto Financial
Unique merchant ID assigned by Hecto Financial
nxhp_sb_hd: Hybrid Capture sandbox
Parameter
Type
Description
Example
mchtIdRequired
AN(10)
Unique merchant ID assigned by Hecto Financial
nxhp_sb_hd: Hybrid Capture sandbox
nxhp_sb_hd
└verAN(4)Alphanumeric, up to 4 bytes*Message version
Message version
*Fixed value
Parameter
Type
Description
Example
verRequired
AN(4)
Message version
* Fixed value
0A19
└methodA(2)Alphabetic, up to 2 bytes*Payment method
Payment method
*Fixed value (MP: Mobile Payment)
Parameter
Type
Description
Example
methodRequired
A(2)
Payment method
* Fixed value (MP: Mobile Payment)
MP
└bizTypeAN(2)Alphanumeric, up to 2 bytes*Business type code
Business type code
B0: Payletter resale approval B2: Hecto Financial original approval
*B0: Payletter resale approval, B2: Hecto Financial original approval
Parameter
Type
Description
Example
bizTypeRequired
AN(2)
Business type code
B0: Payletter resale approval / B2: Hecto Financial original approval
* B0: Payletter resale approval, B2: Hecto Financial original approval
B2
└encCdN(2)Numeric, up to 2 bytes*Encryption type code
Encryption type code
*Fixed value
Parameter
Type
Description
Example
encCdRequired
N(2)
Encryption type code
* Fixed value
23
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytes*Unique order number generated by the merchant (must match the value used in the authentication request)
Unique order number generated by the merchant (must match the value used in the authentication request)
Parameter
Type
Description
Example
mchtTrdNoRequired
AN(100)
Unique order number generated by the merchant (must match the value used in the authentication request)
ORDER20211231100000
└trdDtN(8)Numeric, up to 8 bytes*Request date (YYYYMMDD)
Request date (YYYYMMDD)
Parameter
Type
Description
Example
trdDtRequired
N(8)
Request date (YYYYMMDD)
20211231
└trdTmN(6)Numeric, up to 6 bytes*Request time (HHMMSS)
Request time (HHMMSS)
Parameter
Type
Description
Example
trdTmRequired
N(6)
Request time (HHMMSS)
100000
└mobileYnA(1)Alphabetic, up to 1 bytesMobile indicator
Mobile indicator
Y: Mobile web/app N: PC or other
Parameter
Type
Description
Example
mobileYn
A(1)
Mobile indicator
Y: Mobile web/app / N: PC or other
N
└osTypeA(1)Alphabetic, up to 1 bytesOS type
OS type
A: Android I: iOS W: Windows M: Mac E: Other
Parameter
Type
Description
Example
osType
A(1)
OS type
A: Android / I: iOS / W: Windows / M: Mac / E: Other
W

data Object

└pktHashAN(64)Alphanumeric, up to 64 bytes*SHA-256Hash value generated using SHA256(auto-generated)
Hash value generated using SHA256
Parameter
Type
Description
Example
pktHashRequired
AN(64)
SHA-256
Hash value generated using SHA256
-
NOTE

Hash Generation Combination

trdDt + trdTm + mchtId + mchtTrdNo + trdAmt (plaintext) + hashKey
└phoneNoN(11)Numeric, up to 11 bytesAES-256AES-256/ECB/PKCS5Padding + Base64Customer mobile phone number
Customer mobile phone number
Parameter
Type
Description
Example
phoneNo
N(11)
AES-256
Customer mobile phone number
01012345678
└telCoA(3)Alphabetic, up to 3 bytesAES-256AES-256/ECB/PKCS5Padding + Base64Carrier
Carrier
SKT: SK Telecom KTF: KT LGT: LG U+ CJH: CJ Hello Mobile KCT: Korea Cable Telecom SKL: SK 7Mobile
Parameter
Type
Description
Example
telCo
A(3)
AES-256
Carrier
SKT: SK Telecom / KTF: KT / LGT: LG U+ / CJH: CJ Hello Mobile / KCT: Korea Cable Telecom / SKL: SK 7Mobile
SKT
└emailAN(60)Alphanumeric, up to 60 bytesCustomer email address
Customer email address
Parameter
Type
Description
Example
email
AN(60)
Customer email address
test@example.com
└mUserIdAHN(50)Alphanumeric + Korean, up to 50 bytesMerchant customer ID
Merchant customer ID
Parameter
Type
Description
Example
mUserId
AHN(50)
Merchant customer ID
HongGilDong
└crcCdA(3)Alphabetic, up to 3 bytes*Currency code
Currency code
*Fixed value
Parameter
Type
Description
Example
crcCdRequired
A(3)
Currency code
* Fixed value
KRW
└trdAmtN(12)Numeric, up to 12 bytes*AES-256AES-256/ECB/PKCS5Padding + Base64Transaction amount
Transaction amount
Parameter
Type
Description
Example
trdAmtRequired
N(12)
AES-256
Transaction amount
1000
└prdtNmAHN(128)Alphanumeric + Korean, up to 128 bytes*Product name
Product name
Parameter
Type
Description
Example
prdtNmRequired
AHN(128)
Product name
Test Product
└sellerNmAHN(128)Alphanumeric + Korean, up to 128 bytesSeller name
Seller name
Parameter
Type
Description
Example
sellerNm
AHN(128)
Seller name
Hecto Financial
└ordNmAHN(30)Alphanumeric + Korean, up to 30 bytesOrderer name
Orderer name
Parameter
Type
Description
Example
ordNm
AHN(30)
Orderer name
Hong Gil-dong
└getBillKeyYnA(1)Alphabetic, up to 1 bytesBill key issuance flag
Bill key issuance flag
Y: Issue bill key Other: Do not issue bill key
Parameter
Type
Description
Example
getBillKeyYn
A(1)
Bill key issuance flag
Y: Issue bill key / Other: Do not issue bill key
-
└authTrdNoAN(40)Alphanumeric, up to 40 bytes*Transaction number returned by Hecto Financial upon authentication success
Transaction number returned by Hecto Financial upon authentication success
Parameter
Type
Description
Example
authTrdNoRequired
AN(40)
Transaction number returned by Hecto Financial upon authentication success
SOFP_PGMPnxhp_pl_hd0211021111808M1234567
└linkMethodAN(12)Alphanumeric, up to 12 bytes*Integration method code
Integration method code
*Fixed value
Parameter
Type
Description
Example
linkMethodRequired
AN(12)
Integration method code
* Fixed value
HBRD
└notiUrlAN(250)Alphanumeric, up to 250 bytes*URL of the endpoint to receive payment results (server-to-server webhook URL)
URL of the endpoint to receive payment results (server-to-server webhook URL)
Parameter
Type
Description
Example
notiUrlRequired
AN(250)
URL of the endpoint to receive payment results (server-to-server webhook URL)
https://example.com/notiUrl
└mchtParamAHN(4000)Alphanumeric + Korean, up to 4000 bytesMerchant reserved field
Merchant reserved field
Parameter
Type
Description
Example
mchtParam
AHN(4000)
Merchant reserved field
name=HongGilDong&age=25

Response Parameters

Type Notation
NNumericAAlphabeticHKoreanANAlphanumericAHNAlphanumeric + Korean
e.g. AN(10) = alphanumeric, up to 10 bytes

params Object

└mchtIdAN(10)Alphanumeric, up to 10 bytes*Merchant IDnxhp_sb_hd
Merchant ID
Parameter
Type
Description
Example
mchtIdRequired
AN(10)
Merchant ID
nxhp_sb_hd
└verAN(4)Alphanumeric, up to 4 bytes*Message version0A19
Message version
Parameter
Type
Description
Example
verRequired
AN(4)
Message version
0A19
└methodA(2)Alphabetic, up to 2 bytes*Payment methodMP
Payment method
Parameter
Type
Description
Example
methodRequired
A(2)
Payment method
MP
└bizTypeAN(2)Alphanumeric, up to 2 bytes*Business type codeB0
Business type code
Parameter
Type
Description
Example
bizTypeRequired
AN(2)
Business type code
B0
└encCdN(2)Numeric, up to 2 bytes*Encryption type code23
Encryption type code
Parameter
Type
Description
Example
encCdRequired
N(2)
Encryption type code
23
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytes*Merchant order numberORDER20211231100000
Merchant order number
Parameter
Type
Description
Example
mchtTrdNoRequired
AN(100)
Merchant order number
ORDER20211231100000
└trdNoAN(40)Alphanumeric, up to 40 bytes*Hecto Financial transaction numberSTFP_PGMPnxhp_sb_hd0211129135810M1494620
Hecto Financial transaction number
Parameter
Type
Description
Example
trdNoRequired
AN(40)
Hecto Financial transaction number
STFP_PGMPnxhp_sb_hd0211129135810M1494620
└trdDtN(8)Numeric, up to 8 bytes*Request date (YYYYMMDD)20211231
Request date (YYYYMMDD)
Parameter
Type
Description
Example
trdDtRequired
N(8)
Request date (YYYYMMDD)
20211231
└trdTmN(6)Numeric, up to 6 bytes*Request time (HHMMSS)100000
Request time (HHMMSS)
Parameter
Type
Description
Example
trdTmRequired
N(6)
Request time (HHMMSS)
100000
└outStatCdAN(4)Alphanumeric, up to 4 bytes*Transaction status code (success/failure)0021
Transaction status code (success/failure)
0021: Success 0031: Failure
Parameter
Type
Description
Example
outStatCdRequired
AN(4)
Transaction status code (success/failure)
0021: Success / 0031: Failure
0021
└outRsltCdAN(4)Alphanumeric, up to 4 bytes*Result code0000
Result code
Parameter
Type
Description
Example
outRsltCdRequired
AN(4)
Result code
0000
└outRsltMsgAHN(200)Alphanumeric + Korean, up to 200 bytes*Result messageProcessed successfully.
Result message
Parameter
Type
Description
Example
outRsltMsgRequired
AHN(200)
Result message
Processed successfully.

data Object

└pktHashAN(64)Alphanumeric, up to 64 bytes*Hash value generated using SHA256f395b6725a9a18...
Hash value generated using SHA256
Parameter
Type
Description
Example
pktHashRequired
AN(64)
Hash value generated using SHA256
f395b6725a9a18...
NOTE

Hash Generation Combination

outStatCd + trdDt + trdTm + mchtId + mchtTrdNo + trdAmt (plaintext) + hashKey
└phoneNoN(11)Numeric, up to 11 bytesAES-256AES-256/ECB/PKCS5PaddingCustomer mobile phone number01012341234
Customer mobile phone number
*Certain response fields are AES-256 encrypted. Decrypt them before use.
Parameter
Type
Description
Example
phoneNo
N(11)
AES-256
Customer mobile phone number
* Certain response fields are AES-256 encrypted. Decrypt them before use.
01012341234
└telCoA(3)Alphabetic, up to 3 bytesAES-256AES-256/ECB/PKCS5PaddingCarrierSKT
Carrier
*Certain response fields are AES-256 encrypted. Decrypt them before use.
Parameter
Type
Description
Example
telCo
A(3)
AES-256
Carrier
* Certain response fields are AES-256 encrypted. Decrypt them before use.
SKT
└trdAmtN(12)Numeric, up to 12 bytes*AES-256AES-256/ECB/PKCS5PaddingTransaction amount1000
Transaction amount
*Certain response fields are AES-256 encrypted. Decrypt them before use.
Parameter
Type
Description
Example
trdAmtRequired
N(12)
AES-256
Transaction amount
* Certain response fields are AES-256 encrypted. Decrypt them before use.
1000
└getBillKeyYnA(1)Alphabetic, up to 1 bytesBill key issuance flag
Bill key issuance flag
Y: Bill key issued Other: Bill key not issued
Parameter
Type
Description
Example
getBillKeyYn
A(1)
Bill key issuance flag
Y: Bill key issued / Other: Bill key not issued
-
└billKeyAN(50)Alphanumeric, up to 50 bytesBill key issued by Hecto Financial (used from the 2nd payment onwards)MO0123456789
Bill key issued by Hecto Financial (used from the 2nd payment onwards)
Parameter
Type
Description
Example
billKey
AN(50)
Bill key issued by Hecto Financial (used from the 2nd payment onwards)
MO0123456789
💬

Need technical support?

Code Samples

HectoFinancial GitHub
API Test