Receipt (Sales Slip) Inquiry API (Auth)

An API the merchant calls to inquire a receipt (sales slip). The call returns a purchase verification UI, and the buyer can view the sales slip after entering verification information.

Test Key Information

API Information

POST/api/cpnRcptInq.do

Content-Typeapplication/x-www-form-urlencoded

테스트https://tb-nspay.settlebank.co.kr/api/cpnRcptInq.do

운영https://nspay.settlebank.co.kr/api/cpnRcptInq.do

Important Notes

NOTE

Receipt inquiry with purchase verification

This API includes a purchase verification step. The call returns a verification screen (UI), and the buyer views the sales slip after confirming their identity by entering the buyer name + amount, or email. To receive the sales slip directly without a verification step, use the no-auth version. View Receipt (Sales Slip) Inquiry (No Auth)

Domain notice

This API uses domain2 (tb-nspay / nspay).

Pass the payment method (method) and the Hecto Financial transaction number (trdNo) of the transaction accurately.
The response is a verification screen, not data, so call it via a browser form submit.

Request Parameters

타입 표기법

N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자

예: AN(10) = 영문+숫자, 최대 10byte

└mchtIdAN(10)Alphanumeric, up to 10 bytes*Unique merchant ID assigned by Hecto Financial

Unique merchant ID assigned by Hecto Financial

└methodAN(2)Alphanumeric, up to 2 bytes*Payment method

Payment method

CA: Credit card RA: Account transfer VA: Virtual account MP: Mobile TM: T-money CG: Culture gift card SG: Smart Munsang BG: Book culture gift card HM: Happy Money TC: Teen Cash CP: Point Damoa PZ: Simple payment

*Payment method code of the transaction to inquire. See the payment method code table below.

└trdDtN(8)Numeric, up to 8 bytes*Transaction date (yyyyMMdd)

Transaction date (yyyyMMdd)

└trdNoAN(40)Alphanumeric, up to 40 bytes*Unique transaction number assigned by Hecto Financial

Unique transaction number assigned by Hecto Financial

└pktHashAN(200)Alphanumeric, up to 200 bytes*SHA-256Hash value generated using SHA256(실시간 생성)

Hash value generated using SHA256

NOTE

Hash generation combination

mchtId + trdNo + hashKey

Response

The purchase verification screen (UI) of the requested transaction is returned. At the verification step, entering the buyer name + amount or email of the payment to inquire lets the buyer view the receipt (sales slip). There is no separate data response.

Payment Method Codes

Code	Method	Code	Method
`CA`	Credit card	`RA`	Account transfer
`VA`	Virtual account	`MP`	Mobile
`TM`	T-money	`CG`	Culture gift card
`SG`	Smart Munsang	`BG`	Book culture gift card
`HM`	Happy Money	`TC`	Teen Cash
`CP`	Point Damoa	`PZ`	Simple payment

Need technical support?

Code Samples

HectoFinancial GitHub