헥토파이낸셜 개발자센터

Remittance API

Transfer funds from the merchant server to a customer's account, or query the balance of a remittance-enabled account.

Remittance

Send a remittance from the merchant's master account to a customer's account. Direct contract mode (directYn) is supported by default; reseller mode requires separate consultation. (Please contact your sales representative.)

API Information

POST/v1/api/pay/rmt
Content-Typeapplication/json; charset=UTF-8
테스트https://tbnpay.settlebank.co.kr/v1/api/pay/rmt
운영https://npay.settlebank.co.kr/v1/api/pay/rmt

Request Parameters

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)Alphanumeric, up to 50 bytes*
Message information code.
*Fixed value
└mchtIdAN(8)Alphanumeric, up to 8 bytes*
Merchant ID.
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytes*
Merchant order number (no Korean characters).
└mchtCustIdAN(100)Alphanumeric, up to 100 bytesAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
Customer ID.
└trdDtAN(8)Alphanumeric, up to 8 bytes*
Transaction date (yyyyMMdd).
└trdTmAN(6)Alphanumeric, up to 6 bytes*
Transaction time (HH24MISS).
└bankCdAN(3)Alphanumeric, up to 3 bytes*
Recipient bank code.
└custAcntNoAN(15)Alphanumeric, up to 15 bytes*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
Recipient account number (no hyphens).
└custAcntSumryAN(14)Alphanumeric, up to 14 bytes*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
Recipient bank statement descriptor (full-width characters, up to 7 characters).
└remitterNmAN(14)Alphanumeric, up to 14 bytesAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
Remitter's legal name (required for Kookmin Bank remittance; full-width characters, up to 7 characters).
└directYnA(1)Alphabetic, up to 1 bytes
Direct contract flag (Y: direct contract, N: reseller).
└macntBankCdAN(3)Alphanumeric, up to 3 bytes
Master account bank code (required for direct contract).
└macntNoAN(15)Alphanumeric, up to 15 bytesAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
Master account number (required for direct contract).
└macntSumryAN(12)Alphanumeric, up to 12 bytesAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
Master account bank statement descriptor (required for direct contract; full-width characters, up to 6 characters).
└scrtCardValAN(6)Alphanumeric, up to 6 bytesAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
Security code (required for Standard Chartered Bank direct contract).
└firmPktNoN(6)Numeric, up to 6 bytes
Firm Banking message sequence number.
└macntPwdAN(4)Alphanumeric, up to 4 bytesAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
Master account password (required for MG Community Credit Cooperatives and similar institutions).
└trdAmtN(13)Numeric, up to 13 bytes*
Remittance amount (maximum KRW 1,000,000,000).
└custIpAN(15)Alphanumeric, up to 15 bytes
Customer IP address.
└pktHashAN(200)Alphanumeric, up to 200 bytes*SHA-256(실시간 생성)
SHA-256 HMAC signature.
NOTE

Signature composition

mchtId + mchtTrdNo + trdDt + trdTm + bankCd + custAcntNo + trdAmt (plaintext) + hashKey

Response Parameters

└outStatCdAN(4)Alphanumeric, up to 4 bytes*0021
Transaction status code.
0021: Success 0031: Failure
└outRsltCdAN(4)Alphanumeric, up to 4 bytes*0000
Decline code.
└outRsltMsgAN(300)Alphanumeric, up to 300 bytes*Processed successfully.
Result message.
└mchtTrdNoAN(100)Alphanumeric, up to 100 bytes*OID20210830080000
Merchant order number.
└trdNoAN(40)Alphanumeric, up to 40 bytes*STFP_FIRM1233444365430698
Transaction reference number.
└trdAmtN(13)Numeric, up to 13 bytes*1000
Remittance amount.
└svcDivCdN(4)Numeric, up to 4 bytes*1
Service used for remittance.
1: Firm Banking
💬

Need technical support?