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

Payment API

Sends an Open Banking payment request from the merchant server to the Hecto Financial server. Executes a direct debit against an account that has been registered through account enrollment. As a result of this API call, funds are transferred from the customer's account to the merchant's Open Banking master account.

API Information

POST/v2/api/pay/confirm
Content-Typeapplication/json
Sandboxhttps://tbnpay.settlebank.co.kr/v2/api/pay/confirm
Productionhttps://npay.settlebank.co.kr/v2/api/pay/confirm

Request Parameters

Type Notation
NNumericAAlphabeticHKoreanANAlphanumericAHNAlphanumeric + Korean
e.g. AN(10) = alphanumeric, up to 10 bytes
└hdInfoAN(50)Alphanumeric, up to 50 bytes*Message information code.
Message information code.
*Fixed value
Parameter
Type
Description
Example
hdInfoRequired
AN(50)
Message information code.
* Fixed value
SPAY_RP0W_1.0
└mchtIdAN(8)Alphanumeric, up to 8 bytes*Unique Merchant ID assigned by Hecto Financial.
Unique Merchant ID assigned by Hecto Financial.
Parameter
Type
Description
Example
mchtIdRequired
AN(8)
Unique Merchant ID assigned by Hecto Financial.
midtest
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytes*Merchant order number.
Merchant order number.
*No Korean characters
Parameter
Type
Description
Example
mchtTrdNoRequired
AN(100)
Merchant order number.
* No Korean characters
OID201902210001
└mchtCustIdAN(100)Alphanumeric, up to 100 bytes*AES-256AES-256/ECB/PKCS5Padding + Base64Unique customer ID or key provided by the merchant.
Unique customer ID or key provided by the merchant.
Parameter
Type
Description
Example
mchtCustIdRequired
AN(100)
AES-256
Unique customer ID or key provided by the merchant.
honggidong
└reqDtN(8)Numeric, up to 8 bytes*Request date.
Request date.
*yyyyMMdd
Parameter
Type
Description
Example
reqDtRequired
N(8)
Request date.
* yyyyMMdd
20191231
└reqTmN(6)Numeric, up to 6 bytes*Request time.
Request time.
*HH24MISS
Parameter
Type
Description
Example
reqTmRequired
N(6)
Request time.
* HH24MISS
120000
└trdAmtN(13)Numeric, up to 13 bytes*Transaction amount.
Transaction amount.
*Amount to debit (transaction amount)
Parameter
Type
Description
Example
trdAmtRequired
N(13)
Transaction amount.
* Amount to debit (transaction amount)
1000
└bankCdN(3)Numeric, up to 3 bytes*Debit bank code.
Debit bank code.
*Registered customer's debit bank code
Parameter
Type
Description
Example
bankCdRequired
N(3)
Debit bank code.
* Registered customer's debit bank code
004
└custAcntKeyAN(50)Alphanumeric, up to 50 bytesCustomer account key.
Customer account key.
*Serial number of the registered direct debit account
Parameter
Type
Description
Example
custAcntKey
AN(50)
Customer account key.
* Serial number of the registered direct debit account
d894kjd93kd9
└splAmtN(13)Numeric, up to 13 bytesSupply amount.
Supply amount.
Parameter
Type
Description
Example
splAmt
N(13)
Supply amount.
0
└vatN(13)Numeric, up to 13 bytesVAT amount.
VAT amount.
Parameter
Type
Description
Example
vat
N(13)
VAT amount.
0
└svcAmtN(13)Numeric, up to 13 bytesService charge.
Service charge.
Parameter
Type
Description
Example
svcAmt
N(13)
Service charge.
0
└pmtPrdtNmAN(50)Alphanumeric, up to 50 bytesProduct name for the payment.
Product name for the payment.
*Name of the product being purchased
Parameter
Type
Description
Example
pmtPrdtNm
AN(50)
Product name for the payment.
* Name of the product being purchased
Product name
└custAcntSumryAN(7)Alphanumeric, up to 7 bytesBank statement description.
Bank statement description.
*Text that will appear on the customer's bank statement
Parameter
Type
Description
Example
custAcntSumry
AN(7)
Bank statement description.
* Text that will appear on the customer's bank statement
Kim Hecto
└csrcIssReqYnA(1)Alphabetic, up to 1 bytesCash receipt issuance request.
Cash receipt issuance request.
Y: Issue cash receipt N: Do not issue cash receipt
Parameter
Type
Description
Example
csrcIssReqYn
A(1)
Cash receipt issuance request.
Y: Issue cash receipt / N: Do not issue cash receipt
N
└csrcIssPsblYnA(1)Alphabetic, up to 1 bytesCash receipt issuance eligibility.
Cash receipt issuance eligibility.
Y: Cash receipt issuable transaction N: Cash receipt not issuable transaction
Parameter
Type
Description
Example
csrcIssPsblYn
A(1)
Cash receipt issuance eligibility.
Y: Cash receipt issuable transaction / N: Cash receipt not issuable transaction
N
└taxTypeCdA(1)Alphabetic, up to 1 bytesTax exemption status.
Tax exemption status.
Y: Tax-exempt N: Taxable
*Required when csrcIssReqYn is Y
Parameter
Type
Description
Example
taxTypeCd
A(1)
Tax exemption status.
Y: Tax-exempt / N: Taxable
* Required when csrcIssReqYn is Y
N
└csrcRegPrposYnN(1)Numeric, up to 1 bytesUsage type.
Usage type.
0: Income deduction 1: Expense proof
*Required when csrcIssReqYn is Y
Parameter
Type
Description
Example
csrcRegPrposYn
N(1)
Usage type.
0: Income deduction / 1: Expense proof
* Required when csrcIssReqYn is Y
-
└csrcRegNoDivCdN(1)Numeric, up to 1 bytesIssuance information type.
Issuance information type.
1: Card 2: Resident registration number 3: Business registration number 4: Mobile number
*Required when csrcIssReqYn is Y
Parameter
Type
Description
Example
csrcRegNoDivCd
N(1)
Issuance information type.
1: Card / 2: Resident registration number / 3: Business registration number / 4: Mobile number
* Required when csrcIssReqYn is Y
-
└csrcRegNoAN(20)Alphanumeric, up to 20 bytesAES-256AES-256/ECB/PKCS5Padding + Base64Issuance information value.
Issuance information value.
*Actual value corresponding to csrcRegNoDivCd. Required when csrcIssReqYn is Y.
Parameter
Type
Description
Example
csrcRegNo
AN(20)
AES-256
Issuance information value.
* Actual value corresponding to csrcRegNoDivCd. Required when csrcIssReqYn is Y.
-
└addDdtTypeCdA(1)Alphabetic, up to 1 bytesAdditional deduction type.
Additional deduction type.
Y: Public transportation C: Books, cultural events
Parameter
Type
Description
Example
addDdtTypeCd
A(1)
Additional deduction type.
Y: Public transportation / C: Books, cultural events
-
└custIpAN(15)Alphanumeric, up to 15 bytesCustomer IP address.
Customer IP address.
*The customer device's IP address, not the merchant server IP
Parameter
Type
Description
Example
custIp
AN(15)
Customer IP address.
* The customer device's IP address, not the merchant server IP
127.0.0.1
└pktHashAN(200)Alphanumeric, up to 200 bytes*SHA-256SHA-256 hash value.(auto-generated)
SHA-256 hash value.
*Merchant ID + customer ID (plaintext) + order date + order time + transaction amount + debit bank code + auth key
Parameter
Type
Description
Example
pktHashRequired
AN(200)
SHA-256
SHA-256 hash value.
* Merchant ID + customer ID (plaintext) + order date + order time + transaction amount + debit bank code + auth key
-
└subCpnNmAN(40)Alphanumeric, up to 40 bytesSub-merchant name.
Sub-merchant name.
*Name of the sub-merchant where the transaction occurred
Parameter
Type
Description
Example
subCpnNm
AN(40)
Sub-merchant name.
* Name of the sub-merchant where the transaction occurred
-
└subCpnNoAN(20)Alphanumeric, up to 20 bytesSub-merchant number.
Sub-merchant number.
*Number of the sub-merchant where the transaction occurred
Parameter
Type
Description
Example
subCpnNo
AN(20)
Sub-merchant number.
* Number of the sub-merchant where the transaction occurred
-
└subCpnBizRegNoAN(10)Alphanumeric, up to 10 bytesSub-merchant business registration number.
Sub-merchant business registration number.
*Business registration number of the sub-merchant where the transaction occurred
Parameter
Type
Description
Example
subCpnBizRegNo
AN(10)
Sub-merchant business registration number.
* Business registration number of the sub-merchant where the transaction occurred
-
└lastStlAcntDprNmAN(20)Alphanumeric, up to 20 bytesFinal settlement account holder name.
Final settlement account holder name.
*Bank statement description for the sub-merchant settlement account
Parameter
Type
Description
Example
lastStlAcntDprNm
AN(20)
Final settlement account holder name.
* Bank statement description for the sub-merchant settlement account
-
└lastStlAcntBankCdAN(3)Alphanumeric, up to 3 bytesFinal settlement account bank code.
Final settlement account bank code.
*Sub-merchant settlement account bank code
Parameter
Type
Description
Example
lastStlAcntBankCd
AN(3)
Final settlement account bank code.
* Sub-merchant settlement account bank code
-
└lastStlAcntNoAN(15)Alphanumeric, up to 15 bytesAES-256AES-256/ECB/PKCS5Padding + Base64Final settlement account number.
Final settlement account number.
*Sub-merchant settlement account number, excluding "-"
Parameter
Type
Description
Example
lastStlAcntNo
AN(15)
AES-256
Final settlement account number.
* Sub-merchant settlement account number, excluding "-"
-

Request Hash Code

ItemCombined fields
pktHash valueMerchant ID + customer ID (plaintext) + order date + order time + transaction amount + debit bank code + auth key

Response Parameters

Type Notation
NNumericAAlphabeticHKoreanANAlphanumericAHNAlphanumeric + Korean
e.g. AN(10) = alphanumeric, up to 10 bytes
└outStatCdAN(4)Alphanumeric, up to 4 bytes*Transaction status code (success/failure).
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
-
└outRsltCdAN(4)Alphanumeric, up to 4 bytes*Decline code.
Decline code.
*Refer to rejection code table
Parameter
Type
Description
Example
outRsltCdRequired
AN(4)
Decline code.
* Refer to rejection code table
-
└outRsltMsgAN(200)Alphanumeric, up to 200 bytes*Result message.Processed successfully.
Result message.
*Error details are returned when an error occurs.
Parameter
Type
Description
Example
outRsltMsgRequired
AN(200)
Result message.
* Error details are returned when an error occurs.
Processed successfully.
└trdNoAN(50)Alphanumeric, up to 50 bytes*Hecto Financial transaction reference number.STFP_FIRM12345678901234567890
Hecto Financial transaction reference number.
Parameter
Type
Description
Example
trdNoRequired
AN(50)
Hecto Financial transaction reference number.
STFP_FIRM12345678901234567890
└trdAmtN(13)Numeric, up to 13 bytes*Transaction amount.1000
Transaction amount.
*Amount debited (transaction amount)
Parameter
Type
Description
Example
trdAmtRequired
N(13)
Transaction amount.
* Amount debited (transaction amount)
1000
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytes*Merchant order number.OID201902210001
Merchant order number.
*No Korean characters
Parameter
Type
Description
Example
mchtTrdNoRequired
AN(100)
Merchant order number.
* No Korean characters
OID201902210001
└svcDivCdN(4)Numeric, up to 4 bytes*Service used for the payment.
Service used for the payment.
1: Firm banking 2: Open Banking
*Service used for the payment (direct debit)
Parameter
Type
Description
Example
svcDivCdRequired
N(4)
Service used for the payment.
1: Firm banking / 2: Open Banking
* Service used for the payment (direct debit)
-
└obPsblYnAN(1)Alphanumeric, up to 1 bytesOpen Banking availability.
Open Banking availability.
Y: Available N: Unavailable
*Whether the debit bank supports Open Banking
Parameter
Type
Description
Example
obPsblYn
AN(1)
Open Banking availability.
Y: Available / N: Unavailable
* Whether the debit bank supports Open Banking
-
└macntNoAN(24)Alphanumeric, up to 24 bytesAES-256AES-256/ECB/PKCS5PaddingMaster account number.
Master account number.
*Master account number, excluding "-"
*Certain response fields are AES-256 encrypted. Decrypt them before use.
Parameter
Type
Description
Example
macntNo
AN(24)
AES-256
Master account number.
* Master account number, excluding "-"
* Certain response fields are AES-256 encrypted. Decrypt them before use.
-

Request Example

{
  "hdInfo": "SPAY_RP0W_1.0",
  "mchtId": "midtest",
  "mchtTrdNo": "OID201902210001",
  "mchtCustId": "AES-encrypted customer ID",
  "reqDt": "20191231",
  "reqTm": "120000",
  "trdAmt": "1000",
  "bankCd": "004",
  "custAcntKey": "d894kjd93kd9",
  "splAmt": "0",
  "vat": "0",
  "svcAmt": "0",
  "pmtPrdtNm": "Product name",
  "custAcntSumry": "Kim Hecto",
  "csrcIssReqYn": "N",
  "csrcIssPsblYn": "N",
  "custIp": "127.0.0.1",
  "pktHash": "hash value"
}

Response Example

{
  "outStatCd": "0021",
  "outRsltCd": "0000",
  "outRsltMsg": "Processed successfully.",
  "trdNo": "STFP_FIRM12345678901234567890",
  "trdAmt": "1000",
  "mchtTrdNo": "OID201902210001",
  "svcDivCd": "2",
  "obPsblYn": "Y"
}
💬

Need technical support?

Code Samples

HectoFinancial GitHub