Inicis Payment Integration Manual

https://manual.inicis.com
Admin
Official API documentation and integration guide for Inicis payment processing services, covering...
Tokens:273,562
Snippets:2,934
Trust Score:9.2
Update:4 months ago
Show doc for...
Tokens:
Raw
### Hash Data Encryption Example

Source: https://manual.inicis.com/sa/acctchk-api.html

An example demonstrating how to set up hash data encryption using SHA-512.

```APIDOC
#### ※ Hash 암호화 데이터 설정의 예시
mid | INIpayTest  
---|---  
referenceId | Test1234  
messageType | SS  
recvTel | 01012345678  
hashData = **3876a130ce1c10837401eee13abf1398fe9607af69cade09ced4a57a378e6259d9d5cec8943852cb52b2687d894bc124df0585ddf2d0b9ec769b05acf3a853f4**   
  
(PlainText : ItEQKi3rY7uvDS8l INIpayTest Test1234 SS 01012345678
SHA512 HASH 생성 확인하기
```

--------------------------------

### mKey Generation Example

Source: https://manual.inicis.com/jppay/cbtauth.html

This example illustrates the generation of an mKey by hashing the signKey associated with the MID using SHA256.

```plaintext
SU5JTElURV9UUklQTEVERVNfS0VZU1RS
```

--------------------------------

### Request Payment Example

Source: https://manual.inicis.com/jppay/urlsvc.html

Example of how to initiate a payment request using the EDGEStdPay object. Ensure all required parameters are correctly populated.

```javascript
function request() {

		const obj = {
			P_MID          : "EDGETestId",
			P_OID          : "EDGETestId202309081631579",
			P_PAY_TYPE     : "CARD",
			P_DEVICE_TYPE  : "MOBILE",
			P_IDCCODE      : "Y",
			P_AMT          : "1000",
			P_GOODS        : "이니시스 테스트 상품",
			P_UNAME        : "홍길동",
			P_NEXT_URL     : "{가맹점 도메인}" + "/payResponse",
			P_NOTI_URL     : "{가맹점 도메인}" + "/payResponseNoti",
			P_CLOSE_URL    : "{가맹점 도메인}" + "/close"
			P_CHARSET      : "UTF-8",
			P_TIMESTAMP    : "1708930115213",
			P_CHKFAKE      : "Yi9F7H/G ... 이하 생략",
			P_RESERVED     : '{"email":"test@kggroup.co.kr"}',
		};
		/* 함수 호출 */
		EDGEStdPay.requestPayment(obj);
    }


```

--------------------------------

### SHA-512 Hash Data Generation Example

Source: https://manual.inicis.com/mobile

Example of generating hash data using SHA-512 for mobile payments. This method uses different parameters compared to the SHA-256 example.

```text
INIAPIKey + timestamp + clientIp + mid + tid
```

```text
timestamp | 20230324105710
clientIp | 192.0.0.1
mid | nc3tc02000
tid | INIAPIARSCnc3tc0200020230414093714937182
hashData = **611ff95f4c3e337de3829e27ba4a61f4786cc6fe07e7140b14cbf3ccec7f7d0576a8082ff66a41dcbd0b0d5c03bc350e6c5967fafc65080fa0b4c86aaec72325**
(PlainText : bWXIFC9s24h8BVvW 20230324105710 192.0.0.1 nc3tc02000 INIAPIARSCnc3tc0200020230414093714937182
```

--------------------------------

### Hash Data Example for INILite Key

Source: https://manual.inicis.com/iniweb/recp.html

Example of setting up parameters and the resulting hashData when using the INILite key. This includes parameters like timestamp, mid, reqtype, webordernumber, currency, and price.

```text
timestamp | 20210202144014
mid | WCtestUSD1
reqtype | authreq
webordernumber | test_oid_20210202144014
currency | USD
price | 0.01
hashData = **484ff466688f2c96eb1994aaf589f5ccf004e6c55961b5f4086251fc0fd10d35c8cad8972dcb8b2a440b436dcab408b406dbcffc50bc9dcc52e5504981cae741** 

(PlainText : 20210202144014 WCtestUSD1 authreq test_oid_20210202144014 USD 0.01 YWNTcW9nMEpDRVhIWVJBOTlpT0QyUT09)
SHA512 HASH 생성 확인하기
```

--------------------------------

### Hash Data Example for Inquiry

Source: https://manual.inicis.com/iniweb/recp.html

Example of setting up parameters and the resulting hashData for an inquiry transaction. This includes parameters like timestamp, clientIp, mid, and tid.

```text
timestamp | 20230324105710
clientIp | 192.0.0.1
mid | nc3tc02000
tid | INIAPIARSCnc3tc0200020230414093714937182
hashData = **611ff95f4c3e337de3829e27ba4a61f4786cc6fe07e7140b14cbf3ccec7f7d0576a8082ff66a41dcbd0b0d5c03bc350e6c5967fafc65080fa0b4c86aaec72325** 

(PlainText : bWXIFC9s24h8BVvW 20230324105710 192.0.0.1 nc3tc02000 INIAPIARSCnc3tc0200020230414093714937182
SHA512 HASH 생성 확인하기
```

--------------------------------

### Network Cancellation Response Example

Source: https://manual.inicis.com/rtpay/inquiry.html

Example of a network cancellation response in JSON format.

```json
HTTP/1.1 200 ok Content-type: application/json; charset=UTF-8" \n-d "{ \"resultCode\": \"00\", \"resultMsg\": \"success\", \"subDataCount\" : \"2\", \"subData\": [{ \"mid\": \"hantest001\", \"tid\": \"INIAPICARDhantest00120201109123512121234\", \"price\": \"50000\", \"cancelDate\" : \"20201216\", \"cancelTime\" : \"152000\" }, { \"mid\": \"hantest001\", \"tid\": \"INIAPICARDhantest00120201109123512121234\", \"price\": \"50000\", \"cancelDate\" : \"20201216\", \"cancelTime\" : \"152000\", \"resultMsg\" : \"정상처리되었습니다.\" } ] }"
```

--------------------------------

### SHA-256 Hash Data Generation Example

Source: https://manual.inicis.com/sa/auth.html

Example demonstrating how to construct and hash data using SHA-256 for authentication. Ensure all parameters are correctly formatted before hashing.

```text
Current Date | 20250605
idMerchant | merchantID
noAcct | 1234567890
X-API-KEY | AB1234567891234ABCD123456789ABCD123456789ABCD123456789AB12345678
hashData = **57f87ec092d95559621027306fa591edf04723e8f8c4ce484cdcd6c3df19d9b7**   
  
(plainText : 20250605 merchantID 1234567890 AB1234567891234ABCD123456789ABCD123456789ABCD123456789AB12345678 )
```

--------------------------------

### Network Cancellation Request Example

Source: https://manual.inicis.com/rtpay/inquiry.html

Example of a network cancellation request using cURL.

```bash
curl -X POST " https://iniapi.inicis.com/api/v1/dividepayNetCancelNetCancel" \n-H "Content-type: application/json" \n-d "{ \"timestamp\": \"20201109110000\", \"clientIp\": \"127.0.0.1\", \"mid\": \"INIpayTest\", \"hashData\": \"zxcvgbmnbsda\", \"subData\": \"Fx21gF6UfTsGH9fchvAe+KCZDB/8D3V6j4boeRmLPBPaCsWEi0hO10vZKpwDtOFcwFeFHxrUaGI+riT9ylsqIpv/RhWzw8IuxSqyAOAUbe5V5vTbO4CTiyJEaLpsAHjrLV6vzFDShQxQs859c6v+NNZsBnUuk1tzchcL2TXXGuCFycRgltPHGSDfHFbD8tzi0t484h8S2fexK29ey928UI2nWWXRV+F2pripYi4C1omNeKwPAHpTUhnNpyLMWQYy3cnM1xDYjS8MZ8ORFHZZQSv93a4t6njKmGNbPQoNXzB29cRymFNY/XAEQ+/fM4hzqacJ2XGxBYOiAfBCZn22iv+XDdKwxGbhPqYfaOKpRF8=\" }"
```

--------------------------------

### Hash Data Example for Payment

Source: https://manual.inicis.com/iniweb/recp.html

Example of setting up parameters and the resulting hashData for a standard payment transaction. This includes parameters like timestamp, clientIp, mid, oid, and price.

```text
timestamp | 20230324105710
clientIp | 192.0.0.1
mid | nc3tc02000
oid | Test1234
price | 1000
buyerTel | 01012345678
buyerHpp | 01011112222
arsTel | 15884954
reqType | SMS
hashData = **32eba503d67568cef11956a2e16ed2af7da782c849f3070a65998940515cdde86bd44eb333b1c64142ec5b431c90c9c46b21b17543627a67a5fc735d9114e3d3** 

(PlainText : bWXIFC9s24h8BVvW 20230324105710 192.0.0.1 nc3tc02000 Test1234 1000 01012345678 01011112222 15884954 SMS
SHA512 HASH 생성 확인하기
```

--------------------------------

### Split Approval Response Example

Source: https://manual.inicis.com/rtpay/inquiry.html

Example of a successful split approval response in JSON format.

```json
HTTP/1.1 200 ok Content-type: application/json; charset=UTF-8" \n-d "{ \"resultCode\": \"00\", \"resultMsg\": \"success\", \"subDataCount\" : \"2\", \"subData\": [{ \"mid\": \"INIBillTst\", \"tid\": \"INIAPICARDINIBillTst20201109123412121234\", \"payDate\": \"20201109\", \"payTime\": \"123412\", \"price\": \"1000\", \"payAuthCode\": \"123456\", \"cardCode\": \"12\", \"cardName\": \"삼성카드\", \"payAuthQuota\": \"00\", \"prtcCode\": \"1\", \"resultCode\": \"00\", \"resultMsg\":\"[Card|정상처리되었습니다.]\" }, { \"mid\": \"INIpayTest\", \"tid\": \"INIAPICARDINIpayTest20201109123512121234\", \"payDate\": \"20201109\", \"payTime\": \"123412\", \"price\": \"50000\", \"payAuthCode\": \"123556\", \"cardCode\": \"12\", \"cardName\": \"삼성카드\", \"payAuthQuota\": \"03\", \"prtcCode\": \"1\", \"resultCode\": \"00\", \"resultMsg\":\"[Card|정상처리되었습니다.]\" } ] }"
```

--------------------------------

### Issuing Sales Receipts (URL Example)

Source: https://manual.inicis.com/pay/qna.html

This example shows how to construct URLs for issuing sales receipts and cash receipts. The customer will need to provide specific information to verify the receipt.

```text
<매출전표>   
“https://iniweb.inicis.com/DefaultWebApp/mall/cr/cm/mCmReceipt_head.jsp?noTid=” + “거래건TID” + “&noMethod=1”   
  
<현금영수증>   
“https://iniweb.inicis.com/DefaultWebApp/mall/cr/cm/Cash_mCmReceipt.jsp?noTid=” + “거래건TID” + “&clpaymethod=22”   
```

--------------------------------

### Net Cancellation Request Example

Source: https://manual.inicis.com/rtpay

Example of a cURL request for net cancellation using the INICIS API.

```bash
curl -X POST " https://iniapi.inicis.com/api/v1/dividepayNetCancelNetCancel" \
 -H "Content-type: application/json" \
 -d "{ \"timestamp\": \"20201109110000\", \"clientIp\": \"127.0.0.1\", \"mid\": \"INIpayTest\", \"hashData\": \"zxcvgbmnbsda\", \"subData\": \"Fx21gF6UfTsGH9fchvAe+KCZDB/8D3V6j4boeRmLPBPaCsWEi0hO10vZKpwDtOFcwFeFHxrUaGI+riT9ylsqIpv/RhWzw8IuxSqyAOAUbe5V5vTbO4CTiyJEaLpsAHjrLV6vzFDShQxQs859c6v+NNZsBnUuk1tzchcL2TXXGuCFycRgltPHGSDfHFbD8tzi0t484h8S2fexK29ey928UI2nWWXRV+F2pripYi4C1omNeKwPAHpTUhnNpyLMWQYy3cnM1xDYjS8MZ8ORFHZZQSv93a4t6njKmGNbPQoNXzB29cRymFNY/XAEQ+/fM4hzqacJ2XGxBYOiAfBCZn22iv+XDdKwxGbhPqYfaOKpRF8=\" } "
```

--------------------------------

### Example of Hash Data for Refund

Source: https://manual.inicis.com/rtpay/mo.html

This example demonstrates the parameters and the resulting hashData for a refund transaction using SHA-512.

```plaintext
mid | INIpayTest
type | refund
timestamp | 20231012145039
data | {"tid":"StdpayCARDINIpayTest20231005123848068162","msg":"취소"}
hashData = **374408b2345dcaa21f4c9d1476f5309f8d95a0458bf8fc656bedb9ae52798fcde78de57b752d12a867a3e03ff005b010b35ee6973ad97a862e4fb4503b6e4218** 

(PlainText : ItEQKi3rY7uvDS8l INIpayTest refund 20231012145039 {"tid":"StdpayCARDINIpayTest20231005123848068162","msg":"취소"}
```

--------------------------------

### INIweb Payment Window Call Example

Source: https://manual.inicis.com/iniweb/recp.html

Example of how to initiate a payment request using the EDGEStdPay.requestPayment function. Ensure to replace placeholder values like {가맹점 도메인} with actual domain information.

```javascript
function request() {

		const obj = {
			P_MID          : "EDGETestId",
			P_OID          : "EDGETestId202309081631579",
			P_PAY_TYPE     : "CARD",
			P_DEVICE_TYPE  : "MOBILE",
			P_IDCCODE      : "Y",
			P_AMT          : "1000",
			P_GOODS        : "이니시스 테스트 상품",
			P_UNAME        : "홍길동",
			P_NEXT_URL     : {가맹점 도메인} + "/payResponse",
			P_NOTI_URL     : {가맹점 도메인} + "/payResponseNoti",
			P_CLOSE_URL    : {가맹점 도메인} + "/close"
			P_CHARSET      : "UTF-8",
			P_TIMESTAMP    : "1708930115213",
			P_CHKFAKE      : "Yi9F7H/G ... 이하 생략",
			P_RESERVED     : '{"email":"test@kggroup.co.kr"}',
		};
		/* 함수 호출 */
		EDGEStdPay.requestPayment(obj);
    }


```

--------------------------------

### Balance Reconciliation Inquiry Response Example

Source: https://manual.inicis.com/rtpay/inquiry.html

Example of a successful balance reconciliation inquiry response in JSON format.

```json
{ \"msg\": \"잔액대사 내역 성공 하였습니다.\", \"code\": \"SD01\", \"data\": { \"noComp\": \"8188501902\", \"totalAmt\": \"51317618\", \"idMerchant\": \"test001010\", \"payTransDt\": \"2025060120250610\" } }
```

--------------------------------

### Verification Generation Example (Approval Request)

Source: https://manual.inicis.com/jppay/cbtauth.html

This example shows how to generate a verification string for an approval request using the NVP method. It includes authToken, signKey, and timestamp.

```plaintext
authToken=authTokenValue&signKey=signKeyValue&timestamp=timestampValue
```

--------------------------------

### Hash Data Example

Source: https://manual.inicis.com/pay/etc-formpay.php

Provides an example of hash data generation, showing the plaintext and the resulting SHA512 hash.

```text
hashData = **3876a130ce1c10837401eee13abf1398fe9607af69cade09ced4a57a378e6259d9d5cec8943852cb52b2687d894bc124df0585ddf2d0b9ec769b05acf3a853f4**   

(PlainText : ItEQKi3rY7uvDS8l INIpayTest Test1234 SS 01012345678
```

--------------------------------

### Hash Data Example for Refund

Source: https://manual.inicis.com/iniweb/recp.html

Example of setting up parameters and the resulting hashData for a refund transaction. This includes parameters like type, paymethod, timestamp, clientIp, mid, and tid.

```text
type | Refund
paymethod | Card
timestamp | 20220824132810
clientIp | 192.0.0.1
mid | nc3tc02000
tid | IniARSCARDnc3tc0200020230414093900ars021
hashData = **1414b8eddb113a6920b388f8a1d2e243faebc72e9059625fba13af00a4f6e09a3de99c798b973f79369f5df420d0d0d2604c74193ac80de1c25f7b61eb2c9408** 

(PlainText : bWXIFC9s24h8BVvW Refund Card 20220824132810 192.0.0.1 nc3tc02000 IniARSCARDnc3tc0200020230414093900ars021 )
SHA512 HASH 생성 확인하기
```

--------------------------------

### Verification Generation Example (Payment Request)

Source: https://manual.inicis.com/jppay/cbtauth.html

This example shows how to generate a verification string for a payment request. It uses the NVP method and requires the signKey. Field order must be alphabetical, and trailing ampersands should be omitted.

```plaintext
oid=INIpayTest_1361252896871
price=1004
signKey=SU5JTElURV9UUklQTEVERVNfS0VZU1RS
timestamp=1361252896871
```

--------------------------------

### Cancellation Request Example

Source: https://manual.inicis.com/iniweb/opmall_aml.html

Example of a cURL request to cancel a payment, including necessary headers and payload data.

```bash
curl -X POST " https://iniapi.inicis.com/api/v1/dividepayNetCancelNetCancel" \ 
-H "Content-type: application/json" \ 
-d "{ \"timestamp\": \"20201109110000\", \"clientIp\": \"127.0.0.1\", \"mid\": \"INIpayTest\", \"hashData\": \"zxcvgbmnbsda\", \"subData\": \"Fx21gF6UfTsGH9fchvAe+KCZDB/8D3V6j4boeRmLPBPaCsWEi0hO10vZKpwDtOFcwFeFHxrUaGI+riT9ylsqIpv/RhWzw8IuxSqyAOAUbe5V5vTbO4CTiyJEaLpsAHjrLV6vzFDShQxQs859c6v+NNZsBnUuk1tzchcL2TXXGuCFycRgltPHGSDfHFbD8tzi0t484h8S2fexK29ey928UI2nWWXRV+F2pripYi4C1omNeKwPAHpTUhnNpyLMWQYy3cnM1xDYjS8MZ8ORFHZZQSv93a4t6njKmGNbPQoNXzB29cRymFNY/XAEQ+/fM4hzqacJ2XGxBYOiAfBCZn22iv+XDdKwxGbhPqYfaOKpRF8=\" } "
```

--------------------------------

### Hash Data Example

Source: https://manual.inicis.com/pay/escrow_m.html

Provides an example of hashData generation using specific parameters for MID, referenceId, messageType, and recvTel. The resulting hashData is shown.

```text
mid | INIpayTest  
---|---  
referenceId | Test1234  
messageType | SS  
recvTel | 01012345678  
hashData = **3876a130ce1c10837401eee13abf1398fe9607af69cade09ced4a57a378e6259d9d5cec8943852cb52b2687d894bc124df0585ddf2d0b9ec769b05acf3a853f4**   
  
(PlainText : ItEQKi3rY7uvDS8l INIpayTest Test1234 SS 01012345678
SHA512 HASH 생성 확인하기
```

--------------------------------

### Separated Approval Response Example

Source: https://manual.inicis.com/rtpay/hpclstatus.html

Example of a successful separated approval response from the Inicis API, detailing transaction information.

```json
HTTP/1.1 200 ok Content-type: application/json; charset=UTF-8" \ 
-d "{ \"resultCode\": \"00\", \"resultMsg\": \"success\", \"subDataCount\" : \"2\", \"subData\": [{ \"mid\": \"INIBillTst\", \"tid\": \"INIAPICARDINIBillTst20201109123412121234\", \"payDate\": \"20201109\", \"payTime\": \"123412\", \"price\": \"1000\", \"payAuthCode\": \"123456\", \"cardCode\": \"12\", \"cardName\": \"삼성카드\", \"payAuthQuota\": \"00\", \"prtcCode\": \"1\", \"resultCode\": \"00\", \"resultMsg\":\"[Card|정상처리되었습니다.]\" }, { \"mid\": \"INIpayTest\", \"tid\": \"INIAPICARDINIpayTest20201109123512121234\", \"payDate\": \"20201109\", \"payTime\": \"123412\", \"price\": \"50000\", \"payAuthCode\": \"123556\", \"cardCode\": \"12\", \"cardName\": \"삼성카드\", \"payAuthQuota\": \"03\", \"prtcCode\": \"1\", \"resultCode\": \"00\", \"resultMsg\":\"[Card|정상처리되었습니다.]\" } ] }"  
```
Tokens:
Raw