Full Integration Flow

White-Label supports two integration methods: the Payment Checkout (UI) method and the Server API (Non-UI) method.

Choosing an Integration Method

Method	Description	Best For
Payment Checkout (UI)	Invoke the standard payment checkout provided by Hecto Financial	Fast integration without building a custom payment UI
Server API (Non-UI)	Call the payment API directly from the merchant server	Merchants that build their own payment UI

Method 1: Payment Checkout (UI) Integration Flow

Customer

Merchant Frontend

Merchant Server

Hecto Financial

11. Payment request

1. Payment request

22. Request order info and hash value

2. Request order info and hash value

33. Return order number + pktHash

3. Return order number + pktHash

44. Open payment checkout (POST /whitelabel/main.do)

4. Open payment checkout (POST /whitelabel/main.do)

55. Display payment checkout

5. Display payment checkout

66. Enter payment information

6. Enter payment information

77. Send payment result (notiUrl)

7. Send payment result (notiUrl)

88. Respond OK

8. Respond OK

99. Payment complete (nextUrl)

9. Payment complete (nextUrl)

Payment Checkout Server Information

Environment	Domain
Sandbox	`tbwl.settlebank.co.kr`
Production	`wl.settlebank.co.kr`

pktHash Signature Composition (Payment Checkout)

Payment Checkout Signature Generation`pktHash`

필드명	파라미터
Merchant ID	`mchtId`
Payment method	`method`
Merchant order number	`mchtTrdNo`
Request date	`trdDt`
Request time	`trdTm`
Transaction amount (plaintext)	`trdAmt`
Hash key	`hashKey`

SHA256(mchtId + method + mchtTrdNo + trdDt + trdTm + trdAmt(plaintext) + hashKey)

Payment Checkout API Reference

Payment Checkout (UI)

Standard payment checkout request parameters and response

Method 2: Server API (Non-UI) Integration Flow

Customer

Merchant Frontend

Merchant Server

Hecto Financial

11. Payment request

1. Payment request

22. Forward payment request

2. Forward payment request

33. Call payment API (POST /whitelabel/v1/pay_confirm.do)

3. Call payment API (POST /whitelabel/v1/pay_confirm.do)

44. Return payment result

4. Return payment result

55. Process payment completion

5. Process payment completion

66. Display result

6. Display result

API Server Information

Environment	Domain
Sandbox	`tbapi.settlebank.co.kr`
Production	`api.settlebank.co.kr`

pktHash Signature Composition (Payment/Void APIs)

Payment/Void API Signature Generation`pktHash`

필드명	파라미터
Request date	`trdDt`
Request time	`trdTm`
Merchant ID	`mchtId`
Merchant order number	`mchtTrdNo`
Transaction amount (plaintext)	`trdAmt`
Hash key	`hashKey`

SHA256(trdDt + trdTm + mchtId + mchtTrdNo + trdAmt(plaintext) + hashKey)

Payment/Void API Reference

Payment API

Non-UI payment request

Void API

Payment void processing

Transaction Inquiry API

Real-time transaction result inquiry

Common Response Codes

Field	Success	Failure
`outStatCd`	`0021`	`0031`
`outRsltCd`	`0000`	Error code

Need technical support?

Code Samples

HectoFinancial GitHub