헥토파이낸셜 개발자센터

Network Void API

Voids a timed-out transaction when the Transaction Result Inquiry API confirms the payment was successfully processed. Use this endpoint when the capture API call timed out on the merchant side but the payment was captured by Hecto Financial.

Test Credentials

API Information

POST/APINetPayCancel.do
Content-Typeapplication/json; charset=UTF-8
테스트https://tbezauthapi.settlebank.co.kr/APINetPayCancel.do
운영https://ezauthapi.settlebank.co.kr:8081/APINetPayCancel.do

Request Parameters

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte

Required Parameters

└hdInfoAN(50)Alphanumeric, up to 50 bytes*
Message type code.
*Fixed value
└apiVerAN(4)Alphanumeric, up to 4 bytes*
API version.
*Fixed value
└mercntIdAN(8)Alphanumeric, up to 8 bytes*
Unique merchant identifier assigned by Hecto Financial.
└trDayN(8)Numeric, up to 8 bytes*
Transaction date from the original order (yyyyMMdd).
└ordNoAN(100)Alphanumeric, up to 100 bytes*
Order number from the original payment request.
└reqDayN(8)Numeric, up to 8 bytes*
Network void request date (yyyyMMdd).
└reqTimeN(6)Numeric, up to 6 bytes*
Network void request time (HH24MISS).
└signatureAN(200)Alphanumeric, up to 200 bytes*SHA-256(실시간 생성)
SHA-256 hash value for tamper protection.
NOTE

Signature Composition

mercntId + ordNo + trDay + reqDay + reqTime + hashKey

Response Parameters

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└resultCdN(1)Numeric, up to 1 bytes*0
Result code.
0: Success -1: Failure
└errCdAN(5)Alphanumeric, up to 5 bytes*0000
Error code. See error code reference.
└resultMsgAN(200)Alphanumeric, up to 200 bytes*Success
Human-readable result message.
└apiVerAN(10)Alphanumeric, up to 10 bytes*1.0
API version echoed from the request.

Request Example

{
  "hdInfo": "IA_NC_1.0_1.0",
  "apiVer": "1.0",
  "mercntId": "ms00003t",
  "trDay": "20190221",
  "ordNo": "OID201902210001",
  "reqDay": "20190221",
  "reqTime": "142120",
  "signature": "[SHA-256 hash]"
}
💬

Need technical support?