헥토파이낸셜 개발자센터

Cash Receipt Issuance Status Inquiry API

Check the NTS issuance status of a cash receipt by order number or approval number.

Important Notes

NOTE

Inquiry Key Input Criteria

This API is used to check the final NTS issuance status. You must enter either transNo (order number) or authNo (approval number), and query the registration status with assort=0 and the void status with assort=1.

API Information

GET/POST/pgtrans/CashReceiptMultiAction.do?_method=getReceiptStatus
Content-Type
요청application/x-www-form-urlencoded;charset=UTF-8
응답text/plain;charset=UTF-8
테스트https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=getReceiptStatus
운영https://cash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=getReceiptStatus

Request Parameters

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└midAN(10)Alphanumeric, up to 10 bytes*
Merchant ID.
└trDtAN(14)Alphanumeric, up to 14 bytes*
Issuance/void request datetime (yyyyMMddHHmmss).
*Full datetime match (to the second) or date-only (YYYYMMDD) is also accepted.
└assortA(1)Alphabetic, up to 1 bytes*
Issuance/void type.
0: Issuance 1: Void
└transNoAN(50)Alphanumeric, up to 50 bytes
Order number (unique merchant identifier).
*Duplicate order numbers are rejected regardless of date. Either transNo or authNo is required.
└authNoAN(9)Alphanumeric, up to 9 bytes
NTS approval number received during issuance/void.
*Either transNo or authNo is required.

Response Parameters

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└resultCdAN(4)Alphanumeric, up to 4 bytes*0021
Response code.
1113: No transaction record 0011: Issuance request pending (before NTS submission or result not yet received) 0021: Issuance successful (NTS normal response) 0031: Issuance failed (NTS error response)
└resultMsgAHN(100)Alphanumeric + Korean, up to 100 bytes*00
Response message.
*1113 (no transaction record), 0011 (issuance request pending): blank / 0021 (issuance successful): '00' / 0031 (issuance failed): NTS error code
└tr_dtN(14)Numeric, up to 14 bytes20220215121346
Issuance datetime (yyyyMMddHHmmss).
└transNoAN(50)Alphanumeric, up to 50 bytesFA202212345666
Order number (unique merchant identifier).
└authNoAN(9)Alphanumeric, up to 9 bytesF67143122
Approval number.

Request Example

https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=getReceiptStatus
&mid=mid_test
&trDt=20220215121346
&assort=0
&transNo=FA202212345666

Or query by approval number:

https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=getReceiptStatus
&mid=mid_test
&trDt=20220215121346
&assort=0
&authNo=F67143122

Response Example

Issuance Request Pending

This is the state before NTS submission, or after NTS submission but before the result has been received.

{
  "resultCd": "0011",
  "resultMsg": "",
  "trDt": "20220215121346",
  "transNo": "FA202212345666",
  "authNo": "F67143122"
}

Issuance Successful

{
  "resultCd": "0021",
  "resultMsg": "00",
  "trDt": "20220215121346",
  "transNo": "FA202212345666",
  "authNo": "F67143122"
}

Issuance Failed

{
  "resultCd": "0031",
  "resultMsg": "TS1(Identity verification information digit error)",
  "trDt": "20220215121346",
  "transNo": "FA202212345666",
  "authNo": "F67143122"
}

No Transaction Record

{
  "resultCd": "1113",
  "resultMsg": "No transaction record",
  "trDt": "",
  "transNo": "",
  "authNo": ""
}
💬

Need technical support?