Search

๐Ÿ†• ์ผํšŒ์„ฑ ๊ฐ„ํŽธ๊ฒฐ์ œ (์นด๋“œ / ๊ณ„์ขŒ)

โ€ข
์ด ๊ธ€์˜ ๋ชฉ์ฐจ

1. ์‹œ์ž‘ํ•˜๋ฉด์„œ

โ€ข
KEY ์ •๋ณด๋ฅผ ํ™•์ธํ–ˆ๋‹ค๋ฉด, ์ด์ œ ๋ณธ๊ฒฉ์ ์œผ๋กœ ์—ฐ๋™์„ ์ค€๋น„ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
โ€ข
ํŽ˜์ดํ”Œ API๋ฅผ ํ†ตํ•ด ํŒŒํŠธ๋„ˆ๋Š” ์„œ๋น„์Šค ํŠน์„ฑ์— ๋งž์ถ˜ ๊ฒฐ์ œ์ˆ˜๋‹จ๊ณผ ๊ฒฐ์ œ๋ฐฉ์‹์„ ๊ตฌํ˜„ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
โ€ข
ํ€ต๊ฐ€์ด๋“œ์—์„œ๋Š” ์ผ๋ฐ˜์ ์ธ ์˜จ๋ผ์ธ ์‡ผํ•‘๋ชฐ์—์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋Š” ์ผํšŒ์„ฑ ๊ฐ„ํŽธ๊ฒฐ์ œ๋ฅผ ์—ฐ๋™ํ•˜๋Š” ๋ฐฉ๋ฒ•์„ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค.
๊ฒฐ์ œ ์—ฐ๋™ ์ „, ์ด๊ณณ์—์„œ ํŽ˜์ดํ”Œ ๊ฒฐ์ œ๋ฅผ ์ง์ ‘ ์ฒดํ—˜ํ•ด๋ณด์„ธ์š”!
๋‹ค๋ฅธ ๊ฒฐ์ œ๋ฐฉ์‹์˜ ์—ฐ๋™๋ฐฉ์‹์„ ์•ˆ๋‚ด๋ฐ›๊ณ  ์‹ถ๋‹ค๋ฉด ์ด๊ณณ ์„ ํด๋ฆญํ•ด์„œ ํ™•์ธํ•ด๋ณด์„ธ์š”.

์ผํšŒ์„ฑ ๊ฐ„ํŽธ๊ฒฐ์ œ์ฐฝ ๋ฏธ๋ฆฌ๋ณด๊ธฐ

์นด๋“œ ๊ฒฐ์ œ
ย ๊ฐœ์ธ๊ณ„์ขŒ ๊ฒฐ์ œ
ย ๋ฒ•์ธ๊ณ„์ขŒ ๊ฒฐ์ œ

2. ํ”„๋กœ์„ธ์Šค ๊ฐœ์š”

์ด ๋ฌธ์„œ์—์„œ๋Š” @7/6/2023 ์ดํ›„๋กœ ์ถ”๊ฐ€๋œ ํด๋ผ์ด์–ธํŠธ ํ‚ค(clientKey)๋กœ ํŒŒํŠธ๋„ˆ ์ธ์ฆ์„ ํ•˜๋Š” ๋ฐฉ์‹์˜ ๊ฒฐ์ œ์ฐฝ ํ˜ธ์ถœ ๊ฐ€์ด๋“œ๋ฅผ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค.
์ผํšŒ์„ฑ ๊ฐ„ํŽธ๊ฒฐ์ œ์˜ ๊ฒฐ์ œ ํ”„๋กœ์„ธ์Šค๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์ง„ํ–‰๋ฉ๋‹ˆ๋‹ค.

3. ๊ฒฐ์ œ

3-1. ๊ตฌ๋งค๋ฒ„ํŠผ ํด๋ฆญ

๊ณ ๊ฐ ๊ฒฐ์ œํŽ˜์ด์ง€(Web)
โ€ข
๊ณ ๊ฐ์ด ํŒŒํŠธ๋„ˆ์˜ ์›น์‚ฌ์ดํŠธ์—์„œ 1,000์›์งœ๋ฆฌ 'ํ…Œ์ŠคํŠธ ์ƒํ’ˆ' ๊ตฌ๋งค๋ฅผ ๊ฒฐ์ •ํ–ˆ์Šต๋‹ˆ๋‹ค.

3-2. ๊ฒฐ์ œ์š”์ฒญ

ํŒŒํŠธ๋„ˆ ๊ฒฐ์ œํŽ˜์ด์ง€(Web)
ํด๋ผ์ด์–ธํŠธ ํ‚ค(clientKey)๋กœ ํŒŒํŠธ๋„ˆ ์ธ์ฆ์„ ํ•˜๊ณ  ๊ฒฐ์ œ์ฐฝ์„ ํ˜ธ์ถœํ•˜๋Š” ๊ฒฝ์šฐ,
ํŒŒํŠธ๋„ˆ์‚ฌ์˜ ๋“ฑ๋ก ๋„๋ฉ”์ธ๊ณผ ๊ฒฐ์ œ์ฐฝ ํ˜ธ์ถœ ๋„๋ฉ”์ธ์˜ ๋ฉ”์ธ ๋„๋ฉ”์ธ์ด ์ผ์น˜ํ•˜๋Š”์ง€ ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค.
์ฆ‰, ๊ฒฐ์ œ์ฐฝ ํ˜ธ์ถœ ๋„๋ฉ”์ธ์˜ ๋ฉ”์ธ ๋„๋ฉ”์ธ์ด ๋“ฑ๋ก๋˜์–ด์žˆ์ง€ ์•Š๋‹ค๋ฉด ํŒŒํŠธ๋„ˆ ์ธ์ฆ์ด ์‹คํŒจ๋˜์–ด ์š”์ฒญ์ด ๊ฑฐ๋ถ€๋˜๋‹ˆ, ์ด ์  ๊ผญ ์œ ์˜ํ•ด์ฃผ์„ธ์š”!
๊ฒฐ์ œ์ฐฝ ๋งŒ๋ฃŒ ์‹œ๊ฐ„์€ 30๋ถ„์ด๋‹ˆ, ์ด ์  ์ฐธ๊ณ ํ•˜์—ฌ ๊ฒฐ์ œ ์ง„ํ–‰ํ•ด์ฃผ์‹œ๊ธฐ ๋ฐ”๋ž๋‹ˆ๋‹ค.

Payple Payment Script

โ€ข
๊ฒฐ์ œ์ฐฝ์„ ํ˜ธ์ถœํ•  ์ˆ˜ ์žˆ๋Š” ์Šคํฌ๋ฆฝํŠธ๋ฅผ ์ถ”๊ฐ€ํ•˜์—ฌ ํŽ˜์ดํ”Œ์— ์š”์ฒญํ•ฉ๋‹ˆ๋‹ค.
@7/6/2023 ์ดํ›„ ์ถ”๊ฐ€๋œ ํด๋ผ์ด์–ธํŠธ ํ‚ค(clientKey) ๋ฐฉ์‹์˜ ํŒŒํŠธ๋„ˆ ์ธ์ฆ ๋ฐฉ์‹์œผ๋กœ ๊ฒฐ์ œ์ฐฝ์„ ํ˜ธ์ถœํ•˜๋Š” ๊ฒฝ์šฐ, ์•„๋ž˜ ์Šคํฌ๋ฆฝํŠธ๋ฅผ ์ถ”๊ฐ€ํ•˜์—ฌ ์š”์ฒญํ•˜์…”์•ผํ•˜๋‹ˆ ์ฐธ๊ณ ํ•ด์ฃผ์‹œ๊ธฐ ๋ฐ”๋ž๋‹ˆ๋‹ค.
// ์„œ๋ฒ„๋ณ„ ํŽ˜์ดํ”Œ ๊ตญ๋‚ด๊ฒฐ์ œ ์Šคํฌ๋ฆฝํŠธ ์ถ”๊ฐ€ <script src="https://democpay.payple.kr/js/v1/payment.js"></script> // ํ…Œ์ŠคํŠธ(TEST) <script src="https://cpay.payple.kr/js/v1/payment.js"></script> // ์šด์˜(REAL)
JavaScript
๋ณต์‚ฌ
ํŽ˜์ดํ”Œ ๊ฒฐ์ œ์ฐฝ ์Šคํฌ๋ฆฝํŠธ ์ถ”๊ฐ€
โ€ข
ํŽ˜์ดํ”Œ ๊ตญ๋‚ด๊ฒฐ์ œ ์Šคํฌ๋ฆฝํŠธ๋ฅผ ์ถ”๊ฐ€ํ•œ ํ›„ ๊ฒฐ์ œ์š”์ฒญ ํŒŒ๋ผ๋ฏธํ„ฐ๋ฅผ Object ๊ฐ์ฒด์— ๋‹ด์•„ PaypleCpayAuthCheck(Object)๋ฅผ ํ˜ธ์ถœํ•˜๋ฉด ๊ฒฐ์ œ์ฐฝ์ด ์—ด๋ฆฝ๋‹ˆ๋‹ค.
๊ฒฐ์ œ์ฐฝ ์š”์ฒญ ์˜ˆ์‹œ
// ํŽ˜์ดํ”Œ ๊ตญ๋‚ด๊ฒฐ์ œ ๊ฒฐ์ œ์ฐฝ ํ˜ธ์ถœ function requsetPayplePay() { // obj์— ๊ฒฐ์ œ์š”์ฒญ ํŒŒ๋ผ๋ฏธํ„ฐ ์ €์žฅ let obj = new Object(); /* ์ค‘๋žต */ // ๊ฒฐ์ œ์š”์ฒญ ํ•จ์ˆ˜ ํ˜ธ์ถœ PaypleCpayAuthCheck(obj); }
JavaScript
๋ณต์‚ฌ
JavaScript
์ƒ˜ํ”Œ์ฝ”๋“œ๋Š” ํŒŒ๋ผ๋ฏธํ„ฐ ์ •๋ณด ํ•˜๋‹จ๊ณผ ์—ฐ๋™๊ฐ€์ด๋“œ > ์ƒ˜ํ”Œ์ฝ”๋“œ์—์„œ ํ™•์ธํ•ด๋ณด์„ธ์š”!
PCD_PAY_OID Parameter๋Š” ๊ฑฐ๋ž˜์˜ ๊ณ ์œ ์‹๋ณ„๋ฒˆํ˜ธ์ž…๋‹ˆ๋‹ค. ์š”์ฒญ์‹œ๋งˆ๋‹ค ์œ ๋‹ˆํฌํ•˜๊ฒŒ ์ƒˆ๋กœ ์ง€์ •ํ•ด ์ฃผ์„ธ์š”. PCD_PAY_OID ๊ฐ€ ์ค‘๋ณต๋˜๋ฉด ์ฒ˜์Œ ์ฒ˜๋ฆฌ์™„๋ฃŒ๋œ ๊ฑฐ๋ž˜๋ณด๋‹ค ๋‚˜์ค‘์— ๋“ค์–ด์˜จ ๊ฑฐ๋ž˜์š”์ฒญ๊ฑด์€ ์ค‘๋ณต์‹œ๋„๋กœ ํŒ๋‹จ๋˜์–ด ๊ฑฐ์ ˆ๋ฉ๋‹ˆ๋‹ค.
โ†’ ์ด๋Ÿฌํ•œ ์ด์œ ๋กœ, ํŒŒํŠธ๋„ˆ์‚ฌ์—์„œ ์œ ๋‹ˆํฌํ•˜๊ฒŒ ์ฃผ๋ฌธ๋ฒˆํ˜ธ๋ฅผ ์ง€์ •ํ•  ์ˆ˜ ์—†์„ ๊ฒฝ์šฐ์—๋Š” ์ฃผ๋ฌธ๋ฒˆํ˜ธ๋Š” ๋ฏธ์ง€์ •ํ•˜๋Š” ๊ฒƒ์„ ๊ถŒ์žฅํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.
โ€ป ํŒŒํŠธ๋„ˆ๊ฐ€ ์ฃผ๋ฌธ๋ฒˆํ˜ธ๋ฅผ ๋ฏธ์ง€์ • ์‹œ, ํŽ˜์ดํ”Œ์—์„œ๋Š” ์ž„์˜์˜ ์ฃผ๋ฌธ๋ฒˆํ˜ธ๋ฅผ ์ƒ์„ฑํ•˜์—ฌ ๋ฆฌํ„ดํ•˜์—ฌ ๋“œ๋ฆฝ๋‹ˆ๋‹ค.

Request Parameters

Search
๊ฒฐ์ œ์ˆ˜๋‹จ
Parameter
๋” ์•Œ์•„๋ณด๊ธฐ
Parameter value
Type (Length)
ํ•„์ˆ˜
Reference
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_TYPE
Open
"card"
a(20)
Y
๊ฒฐ์ œ์ˆ˜๋‹จ ์„ ํƒ - card: ์นด๋“œ | transfer: ๊ณ„์ขŒ
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_WORK
Open
"PAY"
A(20)
Y
๊ฒฐ์ œ์š”์ฒญ ๋ฐฉ์‹
์นด๋“œ
PCD_CARD_VER
Open
"01"
N(2)
Y
01 : ํŽ˜์ดํ”Œ ๊ฐ„ํŽธ๊ฒฐ์ œ
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_GOODS
Open
"ํ…Œ์ŠคํŠธ ์ƒํ’ˆ๋ช…"
aAHNS(255)
Y
๊ฒฐ์ œ ์ƒํ’ˆ๋ช…
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_TOTAL
Open
"1000"
N(10)
Y
๊ฒฐ์ œ ์š”์ฒญ๊ธˆ์•ก
์นด๋“œ
๊ณ„์ขŒ
PCD_RST_URL
Open
"https://paytest.com"
aNS
Y
๊ฒฐ์ œ๊ฒฐ๊ณผ ๋ฐ˜ํ™˜URL - ์ƒ์„ธํ•œ ์„ค๋ช…์€ย ์—ฌ๊ธฐย ์—์„œ ํ™•์ธ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. <PCD_RST_URL์˜ ๋‘ ๊ฐ€์ง€ ์—ญํ• > 1. ๊ฒฐ์ œ๊ฒฐ๊ณผ ์ˆ˜์‹  - ์ฝœ๋ฐฑํ•จ์ˆ˜(callbackFunction)๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด PCD_RST_URL์— ์„ค์ •ํ•œ URL๋กœ ๊ฒฐ๊ณผ๋ฅผ ์ˆ˜์‹ ํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. 2. ๊ฒฐ์ œ์ฐฝ ํ˜ธ์ถœ๋ฐฉ์‹ ์ง€์ • - ๊ฒฐ์ œ์ฐฝ ํ˜ธ์ถœ๋ฐฉ์‹ ์„ค์ •๊ฒฝ๋กœ๋ฅผ ์ƒ๋Œ€๊ฒฝ๋กœ๋กœ ์ง€์ •ํ•˜๋ฉด ํŒ์—…๋ฐฉ์‹์œผ๋กœ, ์ ˆ๋Œ€๊ฒฝ๋กœ๋กœ ์ง€์ •ํ•˜๋ฉด ๋‹ค์ด๋ ‰ํŠธ ๋ฐฉ์‹์œผ๋กœ ๊ฒฐ์ œ์ฐฝ์ด ํ˜ธ์ถœ๋ฉ๋‹ˆ๋‹ค.
์นด๋“œ
๊ณ„์ขŒ
clientKey
Open
"test_EDr34dfeโ€ฆ"
Y
ํŒŒํŠธ๋„ˆ ํด๋ผ์ด์–ธํŠธ ํ‚ค(clientKey) - ๊ฒฐ์ œ์ฐฝ ํ˜ธ์ถœ์‹œ ํŒŒํŠธ๋„ˆ ์ธ์ฆ์„ ์œ„ํ•œ Key๊ฐ’์œผ๋กœ, ํ•ด๋‹น ๊ฐ’์ด ์—†์œผ๋ฉด ํŒŒํŠธ๋„ˆ ์ธ์ฆ์ด ๋˜์ง€ ์•Š์•„ ๊ฒฐ์ œ์š”์ฒญ์ด ๊ฑฐ๋ถ€๋ฉ๋‹ˆ๋‹ค. - ํ•ด๋‹น ๊ฐ’์€ ํŒŒํŠธ๋„ˆ๊ด€๋ฆฌ์ž ๊ธฐ๋ณธ์ •๋ณด์—์„œ ํ™•์ธํ•˜์‹ค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. - ์š”์ฒญ ์„œ๋ฒ„์— ๋งž๋Š” ํด๋ผ์ด์–ธํŠธ ํ‚ค(clientKey)๋ฅผ ๋ณด๋‚ด์ฃผ์‹œ๊ธฐ ๋ฐ”๋ž๋‹ˆ๋‹ค. - ์ž์„ธํ•œ ๋‚ด์šฉ โ€˜๋” ์•Œ์•„๋ณด๊ธฐโ€™์—์„œ ํ™•์ธํ•ด๋ณด์„ธ์š”.
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_OID
Open
"ORDER_17027809"
aN(255)
N
์ฃผ๋ฌธ๋ฒˆํ˜ธ - ๊ฑฐ๋ž˜์— ๋Œ€ํ•œ ๊ณ ์œ ์‹๋ณ„๋ฒˆํ˜ธ์ด๋ฏ€๋กœ ํ•ญ์ƒ ์œ ๋‹ˆํฌํ•˜๊ฒŒ ์ง€์ •ํ•˜์—ฌ์•ผ ํ•ฉ๋‹ˆ๋‹ค. - ํŒŒํŠธ๋„ˆ์‚ฌ์—์„œ ์œ ๋‹ˆํฌํ•˜๊ฒŒ ์ฃผ๋ฌธ๋ฒˆํ˜ธ๋ฅผ ์ง€์ •ํ•  ์ˆ˜ ์—†๋Š” ๊ฒฝ์šฐ ์ฃผ๋ฌธ๋ฒˆํ˜ธ๋Š” ๋ฏธ์ง€์ • ํ•˜๋Š”๊ฒƒ์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค.
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_NO
Open
"1234"
N(20)
N
ํŒŒํŠธ๋„ˆ์—์„œ ์‚ฌ์šฉํ•˜๋Š” ํšŒ์›๋ฒˆํ˜ธ *ํšŒ์›๋ฒˆํ˜ธ์˜ maxValue๋Š” 18446744073709551615 ์ด๋‹ˆ ์š”์ฒญ์‹œ ์œ ์˜ํ•ด์ฃผ์„ธ์š”.
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_NAME
Open
"ํ™๊ธธ๋™"
aAH(80)
N
๊ฒฐ์ œ๊ณ ๊ฐ ์ด๋ฆ„
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_HP
Open
"01012345678"
N(15)
N
๊ฒฐ์ œ๊ณ ๊ฐ ํœด๋Œ€์ „ํ™”๋ฒˆํ˜ธ๋ฅผ ์ „์†กํ•˜์‹œ๋ฉด ๊ณ ๊ฐ์˜ ์Šน์ธ๋ฌธ์ž ๋ฏผ์›์„ ๋ฐฉ์ง€ํ•˜๊ธฐ ์œ„ํ•œ ์•Œ๋ฆผํ†ก์ด ๋ฐœ์†ก๋ฉ๋‹ˆ๋‹ค. *๊ฒฐ์ œ์ˆ˜๋‹จ๋ณ„ ํœด๋Œ€์ „ํ™”๋ฒˆํ˜ธ ๊ธฐ๋Šฅ์€ ๋” ์•Œ์•„๋ณด๊ธฐ ๋งํฌ์—์„œ ํ™•์ธํ•ด์ฃผ์„ธ์š”.
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_EMAIL
Open
"test@payple.kr"
E(100)
N
ํ•ด๋‹น ์ด๋ฉ”์ผ ์ฃผ์†Œ๋กœ ๊ฒฐ์ œ ์•ˆ๋‚ด๋ฉ”์ผ์ด ๋ฐœ์†ก๋ฉ๋‹ˆ๋‹ค. - ๊ฒฐ์ œ์ฐฝ์—์„œ ์ด๋ฉ”์ผ ์ฃผ์†Œ๋ฅผ ๋ฏธ๋ฆฌ ์ฐฝ์— ์ž…๋ ฅํ•˜๋Š” ๊ธฐ๋Šฅ์„ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค. (์ž์„ธํ•œ ๋‚ด์šฉ์€ ๋” ์•Œ์•„๋ณด๊ธฐ ๋งํฌ์—์„œ ํ™•์ธํ•ด์ฃผ์„ธ์š”.)
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_ISTAX
Open
"Y"
A(1)
N
๊ณผ์„ธ์„ค์ • (Default: Y ์ด๋ฉฐ, ๊ณผ์„ธ:Y, ๋ณตํ•ฉ๊ณผ์„ธ:Y, ๋น„๊ณผ์„ธ: N) - ISTAX : Y, TAXTOTAL: null์ด๋ฉด ํŽ˜์ดํ”Œ์—์„œ 10% ๋ถ€๊ฐ€์„ธ๋ฅผ ์ž๋™์œผ๋กœ ์ ์šฉํ•ฉ๋‹ˆ๋‹ค.
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_TAXTOTAL
Open
"10"
N(9)
N
โฆ ๋ณตํ•ฉ๊ณผ์„ธ(๊ณผ์„ธ+๋ฉด์„ธ) ์ฃผ๋ฌธ๊ฑด์— ํ•„์š”ํ•œ ๊ธˆ์•ก์ด๋ฉฐ ์ด ํŒŒ๋ผ๋ฏธํ„ฐ์— ์ง€์ •ํ•œ ๊ฐ’์ด ๋ถ€๊ฐ€์„ธ๋กœ ์„ค์ •๋˜์–ด์„œ ๊ฒฐ์ œ๋ฉ๋‹ˆ๋‹ค. - ์˜ˆ์‹œ) PCD_PAY_TOTAL = 1000, PCD_PAY_TAXTOTAL = 350 ๋กœ ๋ณด๋‚ผ๊ฒฝ์šฐ, ํ•ด๋‹น ์ฃผ๋ฌธ๊ฑด์˜ ๋ณตํ•ฉ๊ณผ์„ธ๊ฐ€ ๋ณด๋‚ธ ๊ทธ๋Œ€๋กœ์ธ 350์›์œผ๋กœ ์ง€์ •๋ฉ๋‹ˆ๋‹ค. โ€ป ๋ณตํ•ฉ๊ณผ์„ธ์—๋Š” ๊ณต๊ธ‰๊ฐ€์•ก์ด ์•„๋‹Œ ์‹ค์ œ ์‹ ๊ณ ๊ฐ€ ๋  ๋ถ€๊ฐ€์„ธ ๊ธˆ์•ก์„ ์ž…๋ ฅํ•ด์•ผํ•ฉ๋‹ˆ๋‹ค. โฆ ๊ณผ์„ธ ๋˜๋Š” ๋น„๊ณผ์„ธ์˜ ๊ฒฝ์šฐ ์‚ฌ์šฉํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. โฆ ๋“ฑ๋ก๋งŒ ์ˆ˜ํ–‰์‹œ(PCD_PAY_WORK = AUTH)์ผ ๊ฒฝ์šฐ์—๋Š” ๋ฏธ์ž…๋ ฅ
๊ณ„์ขŒ
PCD_TAXSAVE_FLAG
Open
"Y"
A(1)
N
ํ˜„๊ธˆ์˜์ˆ˜์ฆ ๋ฐœํ–‰์ฐฝ์„ ๋…ธ์ถœํ•˜๋Š” ์˜ต์…˜Parameter์ž…๋‹ˆ๋‹ค. - ์‚ฌ์šฉ: Y
์นด๋“œ
๊ณ„์ขŒ
callbackFunction
Open
getResult
N
PCD_RST_URL๋Œ€์‹  ๊ฒฐ์ œ๊ฒฐ๊ณผ๋ฅผ ๋ฐ›์„ ์ˆ˜ ์žˆ๋Š” callback ํ•จ์ˆ˜๋ฅผ ์„ค์ •ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. - ์ƒ์„ธํ•œ ์„ค๋ช…์€ย ์—ฌ๊ธฐย ์—์„œ ํ™•์ธ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
์š”์ฒญ ํŒŒ๋ผ๋ฏธํ„ฐ์˜ Type ๋ณด๋Š” ๋ฐฉ๋ฒ•์— ๋Œ€ํ•ด ๋” ์ž์„ธํžˆ ์•Œ์•„๋ณด์„ธ์š”!
Sample Code
<!-- jQuery --> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script> <!-- ์„œ๋ฒ„๋ณ„ ํŽ˜์ดํ”Œ ๊ตญ๋‚ด๊ฒฐ์ œ ์Šคํฌ๋ฆฝํŠธ ์ถ”๊ฐ€ --> <script src="https://democpay.payple.kr/js/v1/payment.js"></script> <!-- ํ…Œ์ŠคํŠธ(TEST) --> <!-- <script src="https://cpay.payple.kr/js/v1/payment.js"></script> --> <!-- ์šด์˜(REAL) --> <script> $(document).ready( function () { $('#requsetPayplePay').on('click', function (event) { let obj = new Object(); // Pay Request Parameters obj.PCD_PAY_TYPE = "card"; obj.PCD_PAY_WORK = "PAY"; /* 01 : ํŽ˜์ดํ”Œ ๊ฐ„ํŽธ๊ฒฐ์ œ */ obj.PCD_CARD_VER = "01" obj.PCD_PAYER_NO = "1234"; obj.PCD_PAYER_NAME = "ํ™๊ธธ๋™"; obj.PCD_PAYER_HP = "01012345678"; obj.PCD_PAYER_EMAIL = "test@payple.kr"; obj.PCD_PAY_GOODS = "ํ…Œ์ŠคํŠธ ์ƒํ’ˆ๋ช…"; obj.PCD_PAY_TOTAL = "1000"; obj.PCD_PAY_ISTAX = "Y"; obj.PCD_PAY_TAXTOTAL = "10"; /* ๊ฒฐ๊ณผ๋ฅผ ์ฝœ๋ฐฑ ํ•จ์ˆ˜๋กœ ๋ฐ›๊ณ ์ž ํ•˜๋Š” ๊ฒฝ์šฐ ํ•จ์ˆ˜ ์„ค์ • ์ถ”๊ฐ€ */ // obj.callbackFunction = getResult; // getResult : ์ฝœ๋ฐฑ ํ•จ์ˆ˜๋ช… /** * ํŒŒํŠธ๋„ˆ ์ธ์ฆ์„ ์œ„ํ•œ ํด๋ผ์ด์–ธํŠธ ํ‚ค(clientKey) * - ํ•ด๋‹น ํ‚ค ๊ฐ’์€ ํ…Œ์ŠคํŠธ๋ฅผ ์œ„ํ•ด ํŽ˜์ดํ”Œ์—์„œ ์ œ๊ณตํ•˜๋Š” test ๊ณ„์ •์˜ clientKey ๊ฐ’์ž…๋‹ˆ๋‹ค. * - ์ž์„ธํ•œ ๋‚ด์šฉ์€ '๊ฐ€์ž… ๋ฐ KEY ์ •๋ณด ์ˆ˜๋ น'์—์„œ๋„ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. */ obj.clientKey = "test_DF55F29DA654A8CBC0F0A9DD4B556486"; obj.PCD_RST_URL = "/order_result.php"; // ๊ฒฐ์ œ๊ฒฐ๊ณผ ์ˆ˜์‹  URL // ๊ฒฐ์ œ์š”์ฒญ ํ•จ์ˆ˜ ํ˜ธ์ถœ PaypleCpayAuthCheck(obj); }); }); </script> <button id="requsetPayplePay">ํŽ˜์ดํ”Œ ๊ตญ๋‚ด๊ฒฐ์ œ</button>
HTML
๋ณต์‚ฌ

3-3. ๊ฒฐ์ œ ์ง„ํ–‰

๊ณ ๊ฐ ๊ฒฐ์ œ์ฐฝ
โ€ข
ํŽ˜์ดํ”Œ์—์„œ ๊ฒฐ์ œ์ฐฝ์„ ๊ณ ๊ฐ์˜ ๋ธŒ๋ผ์šฐ์ €์— ํ˜ธ์ถœ์‹œํ‚ต๋‹ˆ๋‹ค.
โ€ข
๊ณ ๊ฐ์€ ๊ฒฐ์ œ์ฐฝ์—์„œ ๊ฒฐ์ œ์ •๋ณด๋ฅผ ์ž…๋ ฅํ•˜์—ฌ ๊ฒฐ์ œ๋ฅผ ์™„๋ฃŒํ•ฉ๋‹ˆ๋‹ค.

3-4. ๊ฒฐ์ œ ๊ฒฐ๊ณผ

ํŽ˜์ดํ”Œ ์„œ๋ฒ„
โ€ข
ํŽ˜์ดํ”Œ์—์„œ ๊ณ ๊ฐ์˜ ๊ฒฐ์ œ์ฐฝ์„ ์ข…๋ฃŒ์‹œํ‚ต๋‹ˆ๋‹ค.
โ€ข
PCD_RST_URL๋กœ ๊ณ ๊ฐ์˜ ๋ธŒ๋ผ์šฐ์ €๋ฅผ ๋ฆฌ๋‹ค์ด๋ ‰ํŠธ(Redirect) ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.
โ—ฆ
callbackFunction์œผ๋กœ ๊ฒฐ์ œ๊ฒฐ๊ณผ๋ฅผ ์ˆ˜์‹ ํ•  ๊ฒฝ์šฐ, ์ฝœ๋ฐฑํ•จ์ˆ˜๋กœ ๊ฒฐ์ œ๊ฒฐ๊ณผ๊ฐ€ ๋ฐ˜ํ™˜๋˜๋ฉฐ PCD_RST_URL๋กœ ๊ณ ๊ฐ์˜ ๋ธŒ๋ผ์šฐ์ €๋ฅผ ๋ฆฌ๋‹ค์ด๋ ‰ํŠธ(Redirect) ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.
PCD_RST_URL๊ณผ callbackFunction์— ๋Œ€ํ•œ ์„ค๋ช…์€ ์ด๊ณณ์—์„œ ํ™•์ธํ•ด๋ณด์„ธ์š”!

Response Parameters

โ€ข
ํŒŒํŠธ๋„ˆ๋กœ ๊ฒฐ๊ณผ ๋ฆฌํ„ด(Response)์€ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์ง„ํ–‰๋ฉ๋‹ˆ๋‹ค.
Show All
Search
๊ฒฐ์ œ์ˆ˜๋‹จ
Parameter
๋” ์•Œ์•„๋ณด๊ธฐ
Parameter value
Reference
Type
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_RST
Open
"success"
์š”์ฒญ ๊ฒฐ๊ณผ success, error, close
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_CODE
Open
"0000"
์‘๋‹ต์ฝ”๋“œ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_MSG
Open
"์นด๋“œ์Šน์ธ์™„๋ฃŒ"
์š”์ฒญ ๊ฒฐ๊ณผ ๋ฉ”์‹œ์ง€
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_TYPE
Open
"card"
๊ฒฐ์ œ์ˆ˜๋‹จ(์นด๋“œ: card, ๊ณ„์ขŒ:transfer)
String
์นด๋“œ
PCD_CARD_VER
Open
"01"
์นด๋“œ๊ฒฐ์ œ ์„ธ๋ถ€ ๊ฒฐ์ œ๋ฐฉ์‹ ์„ ํƒ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_WORK
Open
"PAY"
๊ฒฐ์ œ์š”์ฒญ๋ฐฉ์‹
String
์นด๋“œ
๊ณ„์ขŒ
PCD_AUTH_KEY
Open
"K0VnWโ€ฆ"
๊ฒฐ์ œ ํ›„ ๋ฆฌํ„ด ๋ฐ›์€ ํ† ํฐํ‚ค
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_REQKEY
Open
CERT - ๊ฒฐ์ œ์ƒ์„ฑ ํ›„ ์Šน์ธ์„ ์œ„ํ•œ ํ‚ค
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_HOST
Open
"https://democpay.payple.kr"
ํŽ˜์ดํ”Œ ๋„๋ฉ”์ธ ์ฃผ์†Œ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_URL
Open
(CERT๋ฐฉ์‹) ์ตœ์ข… ๊ฒฐ์ œ์š”์ฒญ ์Šน์ธํ‚ค
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_COFURL
Open
(CERT๋ฐฉ์‹) ์ตœ์ข… ๊ฒฐ์ œ์š”์ฒญ URL
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_ID
Open
"OVA3Uโ€ฆ"
๋นŒ๋งํ‚ค โ€ป ์•ฑ์นด๋“œ ๊ฒฐ์ œ(PCD_CARD_VER = โ€˜02โ€™)์ธ ๊ฒฝ์šฐ, ๋นŒ๋งํ‚ค๋Š” ๋ฐ˜ํ™˜๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. - ๋นŒ๋งํ‚ค๋Š” ํŽ˜์ดํ”Œ ๊ฐ„ํŽธ๊ฒฐ์ œ๋กœ ๊ฒฐ์ œ ๋ฐ ๋“ฑ๋ก์‹œ์—๋งŒ ๋ฐ˜ํ™˜๋˜๋Š” ๊ฐ’์ž…๋‹ˆ๋‹ค.
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_NO
Open
"1234"
ํŒŒํŠธ๋„ˆ์‚ฌ์—์„œ ์‚ฌ์šฉํ•˜๋Š” ํšŒ์›๋ฒˆํ˜ธ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_NAME
Open
"ํ™๊ธธ๋™"
๊ณ ๊ฐ ์ด๋ฆ„
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_HP
Open
"01012345678"
๊ณ ๊ฐ ํœด๋Œ€์ „ํ™”๋ฒˆํ˜ธ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_EMAIL
Open
"test@payple.kr"
๊ณ ๊ฐ ์ด๋ฉ”์ผ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_OID
Open
"ORDER_17027809"
์ฃผ๋ฌธ๋ฒˆํ˜ธ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_GOODS
Open
"ํ…Œ์ŠคํŠธ ์ƒํ’ˆ๋ช…"
์ƒํ’ˆ๋ช…
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_AMOUNT
Open
"1000"
๊ฒฐ์ œ๊ธˆ์•ก
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_DISCOUNT
Open
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_AMOUNT_REAL
Open
"1000"
๊ฒฐ์ œ๊ธˆ์•ก
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_TOTAL
Open
"1000"
๊ฒฐ์ œ๊ธˆ์•ก
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_TAXTOTAL
Open
"0"
- ๋ณตํ•ฉ๊ณผ์„ธ(๊ณผ์„ธ+๋ฉด์„ธ) ์ฃผ๋ฌธ๊ฑด์— ํ•„์š”ํ•œ ๊ธˆ์•ก์ด๋ฉฐ, ํŒŒํŠธ๋„ˆ์‚ฌ์—์„œ ์ง€์ •ํ•˜์—ฌ ์ „์†กํ•œ ๊ฐ’์ด ๋ฆฌํ„ด๋ฉ๋‹ˆ๋‹ค. โ€ป๋ณตํ•ฉ๊ณผ์„ธ๋Š” ๊ณต๊ธ‰๊ฐ€์•ก์ด ์•„๋‹Œ ์‹ค์ œ ์‹œ๊ณ ๊ฐ€ ๋œ ๋ถ€๊ฐ€์„ธ ๊ธˆ์•ก์ด ๋ฆฌํ„ด๋ฉ๋‹ˆ๋‹ค.
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_ISTAX
Open
"Y"
๊ณผ์„ธ์„ค์ • (Default: Y ์ด๋ฉฐ, ๊ณผ์„ธ:Y, ๋ณตํ•ฉ๊ณผ์„ธ:Y, ๋น„๊ณผ์„ธ: N)
String
์นด๋“œ
PCD_PAY_CARDNAME
Open
"์‚ผ์„ฑ์นด๋“œ"
์นด๋“œ์‚ฌ๋ช…
String
์นด๋“œ
PCD_PAY_CARDNUM
Open
"1234-****-****-5678"
์นด๋“œ๋ฒˆํ˜ธ
String
์นด๋“œ
PCD_PAY_CARDQUOTA
Open
"00"
์นด๋“œ ํ• ๋ถ€ ๊ฐœ์›” ์ˆ˜
String
์นด๋“œ
PCD_PAY_CARDTRADENUM
Open
"202312191342223302115099"
๊ฑฐ๋ž˜ ํ‚ค
String
์นด๋“œ
PCD_PAY_CARDAUTHNO
Open
"85324231"
์Šน์ธ๋ฒˆํ˜ธ
String
์นด๋“œ
PCD_PAY_CARDRECEIPT
Open
"https://www.danalpay.."
๋งค์ถœ์ „ํ‘œ ์ถœ๋ ฅ ๋งํฌ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_TIME
Open
"20231219134223"
๊ฒฐ์ œ์‹œ๊ฐ„
String
์นด๋“œ
๊ณ„์ขŒ
PCD_SIMPLE_FLAG
Open
"N"
String
์นด๋“œ
๊ณ„์ขŒ
PCD_RST_URL
Open
"/order_result"
๊ฒฐ์ œ(์š”์ฒญ)๊ฒฐ๊ณผ ๋ฐ˜ํ™˜URL
String
๊ณ„์ขŒ
PCD_PAY_BANKACCTYPE
Open
"personal"
ํ˜„๊ธˆ์˜์ˆ˜์ฆ ๋ฐœํ–‰๋Œ€์ƒ (๊ฐœ์ธ:personal, ์‚ฌ์—…์ž:company)
String
๊ณ„์ขŒ
PCD_PAY_BANK
Open
"020"
์€ํ–‰์ฝ”๋“œ
String
๊ณ„์ขŒ
PCD_PAY_BANKNAME
Open
"์šฐ๋ฆฌ์€ํ–‰"
์€ํ–‰๋ช…
String
๊ณ„์ขŒ
PCD_PAY_BANKNUM
Open
"123-********-456"
๊ณ„์ขŒ๋ฒˆํ˜ธ(์ผ๋ถ€ ๋งˆ์Šคํ‚น ์ฒ˜๋ฆฌ)
String
๊ณ„์ขŒ
PCD_TAXSAVE_MGTNUM
Open
"G3482429BV2..."
ํ˜„๊ธˆ์˜์ˆ˜์ฆ ๊ตญ์„ธ์ฒญ ๋ฐœํ–‰๋ฒˆํ˜ธ - PCD_TAXSAVE_FLAG ์‚ฌ์šฉ์‹œ ์‘๋‹ต
String
โ€ข
callbackFunction ์„ ์‚ฌ์šฉํ•œ๋‹ค๋ฉด PCD_RST_URL ์„ ๋Œ€์ฒดํ•˜์—ฌ ๊ฒฐ๊ณผ๋ฅผ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.
โ€ข
Webhook URL ์„ ๋“ฑ๋กํ•˜์˜€๋‹ค๋ฉด ํŽ˜์ดํ”Œ์—์„œ ํ•ด๋‹น URL๋กœ ๊ฒฐ๊ณผ๋ฅผ ์ถ”๊ฐ€๋กœ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.
- ํŽ˜์ดํ”Œ์—์„œ๋Š” ๊ฒฐ๊ณผ ์ˆ˜์‹ ์‹คํŒจ ๋ˆ„๋ฝ์„ ๋ฐฉ์ง€ํ•˜๊ธฐ ์œ„ํ•ด Webhook URL ๋“ฑ๋ก์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค. - ํ…Œ์ŠคํŠธ ์„œ๋ฒ„์—์„œ๋Š” ๋ณ„๋„์˜ ๊ณ„์ •์„ ๋ฐœ๊ธ‰๋ฐ›์ง€ ์•Š๋Š” ํ•œ Webhook URL ๋“ฑ๋ก ๋ฐ ํ…Œ์ŠคํŠธ๊ฐ€ ๋ถˆ๊ฐ€ํ•ฉ๋‹ˆ๋‹ค. - ํ…Œ์ŠคํŠธ ์„œ๋ฒ„์—์„œ Webhook URL์„ ํ…Œ์ŠคํŠธํ•˜๊ธฐ ์œ„ํ•ด์„œ help@payple.kr ๋กœ ์—ฐ๋ฝ์ฃผ์‹œ๋ฉด ํŒŒํŠธ๋„ˆ ์ „์šฉ ํ…Œ์ŠคํŠธ ๊ณ„์ •์„ ๋ฐœ๊ธ‰ํ•˜์—ฌ ๋“œ๋ฆฝ๋‹ˆ๋‹ค. - Webhook URL ๋“ฑ๋ก ์—†์ด ํ…Œ์ŠคํŠธํ•˜์‹œ๋ ค๋ฉด PCD_RST_URL ๋กœ ์ˆ˜์‹ ๋ฐ›์€ Response ๋ฐ์ดํ„ฐ๋กœ ๊ฒฐ๊ณผ๋ฅผ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.

3-5. ๊ฒฐ๊ณผ ์ฒ˜๋ฆฌ

ํŒŒํŠธ๋„ˆ ์„œ๋ฒ„
ํŒŒํŠธ๋„ˆ์—์„œ ํŽ˜์ดํ”Œ์—์„œ ๋ฐ›์€ Response ๋ฐ์ดํ„ฐ๋กœ ๊ฒฐ๊ณผ๋ฅผ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.
โ€ข
PCD_PAY_RST = success, PCD_PAY_CODE = "0000"์ด ํฌํ•จ๋  ๊ฒฝ์šฐ ์š”์ฒญ์„ฑ๊ณต์œผ๋กœ ํŒ๋‹จํ•ฉ๋‹ˆ๋‹ค.
โ€ข
PCD_PAY_RST = error ์ผ ๊ฒฝ์šฐ ์š”์ฒญ์‹คํŒจ๋กœ ํŒ๋‹จํ•ฉ๋‹ˆ๋‹ค.
โ€ข
PCD_PAY_RST = close ์ผ ๊ฒฝ์šฐ ์š”์ฒญ์‹คํŒจ๋กœ ํŒ๋‹จํ•ฉ๋‹ˆ๋‹ค.
๊ณ ๊ฐ์ด ๊ฒฐ์ œ์ฐฝ์„ ๊ฒฐ์ œ ์ค‘ ์ข…๋ฃŒํ•  ๊ฒฝ์šฐ ๋ฆฌํ„ด๋ฉ๋‹ˆ๋‹ค.

3-5-1. ์š”์ฒญ์ด ์„ฑ๊ณตํ–ˆ์„ ๊ฒฝ์šฐ(success)

โ€ข
๋ฐ์ดํ„ฐ ์œ„๋ณ€์กฐ ์—ฌ๋ถ€๋ฅผ ํŒ๋ณ„ํ•˜๊ธฐ ์œ„ํ•ด ๋ฆฌํ„ด๋ฐ›์€ PCD_PAY_TOTAL ๊ฐ’๊ณผ ์š”์ฒญํ–ˆ๋˜ ๊ฐ’์„ ๋Œ€์กฐํ•˜์—ฌ ์ด์ƒ์ด ์—†์Œ์„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
โ€ข
๋ฆฌํ„ด๋ฐ›์€ ๊ฑฐ๋ž˜ ๊ณ ์œ ์‹๋ณ„๋ฒˆํ˜ธ์ธ PCD_PAY_OID๋ฅผ ํ™•์ธํ•˜์—ฌ ์š”์ฒญํ–ˆ๋˜ ๊ฑฐ๋ž˜ ์ •๋ณด์™€ ๋งค์นญ์‹œํ‚ต๋‹ˆ๋‹ค.
โ€ข
๊ฑฐ๋ž˜๋ฅผ ์š”์ฒญํ–ˆ๋˜ ๊ณ ๊ฐ์—๊ฒŒ ์•ฝ์ •๋œ ์„œ๋น„์Šค๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

3-5-2. ์š”์ฒญ์ด ์‹คํŒจํ–ˆ์„ ๊ฒฝ์šฐ(error / close)

โ€ข
PCD_PAY_CODE ์™€ PCD_PAY_MSG ๋กœ ์›์ธ์„ ํŒŒ์•…ํ•˜์—ฌ ๋Œ€์‘ํ•ฉ๋‹ˆ๋‹ค.
โ€ข
์‘๋‹ต์ฝ”๋“œ ๋ฆฌ์ŠคํŠธ ๋ฅผ ํ™•์ธํ•ด๋ณด์„ธ์š”.

3-6 ๊ฒฐ์ œ์š”์ฒญ ์žฌ์ปจํŽŒ (PCD_PAY_WORK: CERT)

ํŒŒํŠธ๋„ˆ ์„œ๋ฒ„
์ตœ์ข… ๊ฒฐ์ œ์š”์ฒญ์„ ์œ„ํ•ด REST API๋ฅผ ํ†ตํ•ด ๊ฒฐ์ œ๋ฅผ ์š”์ฒญํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
PAY(์ฆ‰์‹œ๊ฒฐ์ œ) ๋ฐฉ์‹๊ณผ ๋‹ฌ๋ฆฌ CERT(๊ฒฐ์ œ์š”์ฒญ ์žฌ์ปจํŽŒ) ๋ฐฉ์‹์—์„œ๋Š” ์ตœ์ข… ์Šน์ธ ์š”์ฒญ์„ ๋ณ„๋„๋กœ ๋ณด๋‚ด์•ผํ•ฉ๋‹ˆ๋‹ค.
๊ฒฐ์ œ์ฐฝ์„ ํ˜ธ์ถœํ•˜์—ฌ ๊ฒฐ์ œ๋ฅผ ํ•˜๋Š” ๊ฒฝ์šฐ, ๊ฒฐ์ œ์š”์ฒญ ๋ฐฉ์‹ ํŒŒ๋ผ๋ฏธํ„ฐ์ธ PCD_PAY_WORK๋ฅผ CERT(ํŒŒํŠธ๋„ˆ ํ™•์ธ ํ›„ ๊ฒฐ์ œ)์™€ PAY(๋ธŒ๋ผ์šฐ์ €์—์„œ ์ฆ‰์‹œ๊ฒฐ์ œ) ์ค‘ ํ•˜๋‚˜๋กœ ์ง€์ •ํ•˜์—ฌ์•ผ ํ•ฉ๋‹ˆ๋‹ค.
๊ฒฐ์ œ์š”์ฒญ ๋ฐฉ์‹์— ๋Œ€ํ•œ ์ž์„ธํ•œ ์„ค๋ช…์€ ํŒŒ๋ผ๋ฏธํ„ฐ ์ •์˜: PCD_PAY_WORK์—์„œ ํ™•์ธํ•ด๋ณด์„ธ์š”!
๊ฒฐ์ œ์š”์ฒญ ์žฌ์ปจํŽŒ(CERT) ๋ฐฉ์‹์€ ์•„๋ž˜์™€ ๊ฐ™์€ ํ”„๋กœ์„ธ์Šค๋กœ ๊ฒฐ์ œ๊ฐ€ ์ง„ํ–‰๋ฉ๋‹ˆ๋‹ค.
โ€ข
1 ~ 4 : PAY์™€ ๋งˆ์ฐฌ๊ฐ€์ง€๋กœ ๊ฒฐ์ œ์ฐฝ์„ ๋ธŒ๋ผ์šฐ์ €์— ํ˜ธ์ถœํ•˜์—ฌ ๊ฒฐ์ œ์š”์ฒญ์„ ๋ณด๋‚ด๊ณ  ๊ฒฐ๊ณผ๋ฅผ ๋ฐ›์Šต๋‹ˆ๋‹ค.
์ด๋•Œ, ์‘๋‹ต๊ฒฐ๊ณผ๋ฅผ ๋ฐ›์•„๋„ ์•„์ง ๊ฒฐ์ œ๋Š” ์™„๋ฃŒ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๋‹ค์Œ ๋‹จ๊ณ„๊นŒ์ง€ ๋ชจ๋‘ ์™„๋ฃŒํ•ด์•ผ, ์ฆ‰ ๊ฒฐ์ œ ์ตœ์ข…์Šน์ธ์š”์ฒญ์„ ๋ณด๋‚ด์•ผ ๊ฒฐ์ œ๊ฐ€ ์™„๋ฃŒ๋ฉ๋‹ˆ๋‹ค.
โ€ข
5 ~ 8 : ์ธ์ฆ๊ฒฐ๊ณผ ๋ฐ ๊ฒฐ์ œ์ค€๋น„์™„๋ฃŒ ๋ฆฌํ„ด์„ ๋ฐ›์€ ํ›„, ํŽ˜์ดํ”Œ ์„œ๋ฒ„๋กœ ๊ฒฐ์ œ ์ตœ์ข…์Šน์ธ ์š”์ฒญ์„ ๋ณด๋‚ด๊ณ 
๊ฒฐ๊ณผ๋ฅผ ๋ฐ›์Šต๋‹ˆ๋‹ค. ์ด๋•Œ, ๊ฒฐ์ œ๊ฒฐ๊ณผ๊ฐ€ 'success'๋ฉด ๊ฒฐ์ œ ์™„๋ฃŒ๋กœ ํŒ๋‹จํ•ฉ๋‹ˆ๋‹ค.
๊ฒฐ์ œ์š”์ฒญ ์žฌ์ปจํŽŒ(CERT)์— ํ•ด๋‹นํ•˜๋Š” ๋ถ€๋ถ„์€ 5 ~ 8 ์ž…๋‹ˆ๋‹ค.
๊ฒฐ์ œ์š”์ฒญ ์žฌ์ปจํŽŒ(CERT) ๊ฒฐ์ œ ํ”„๋กœ์„ธ์Šค

Request Parameters

Show All
Search
๊ฒฐ์ œ์ˆ˜๋‹จ
Parameter
๋” ์•Œ์•„๋ณด๊ธฐ
Parameter value
Type (Length)
ํ•„์ˆ˜
Reference
์นด๋“œ
๊ณ„์ขŒ
PCD_CST_ID
Open
"test"
aN(255)
Y
ํŒŒํŠธ๋„ˆ์‚ฌ cst_id
์นด๋“œ
๊ณ„์ขŒ
PCD_CUST_KEY
Open
"abcd1234567890"
aN(255)
Y
ํŒŒํŠธ๋„ˆ์‚ฌ custKey
์นด๋“œ
๊ณ„์ขŒ
PCD_AUTH_KEY
Open
"a688c..."
aNS(255)
Y
CERT ๊ฒฐ์ œ์š”์ฒญ ํ›„ ๋ฆฌํ„ด๋ฐ›์€ ์ธ์ฆ ํ† ํฐ
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_REQKEY
Open
"Vnx..."
aNS
Y
CERT ๊ฒฐ์ œ์š”์ฒญ ํ›„ ๋ฆฌํ„ด๋ฐ›์€ ์ตœ์ข… ์Šน์ธ์š”์ฒญ์šฉ ํ‚ค
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_ID
Open
"OVA3Uโ€ฆ"
aNS(255)
Y
๋นŒ๋งํ‚ค (๋“ฑ๋ก ํ›„ ๋ฐœ๊ธ‰๋ฐ›์€ ํ‚ค๊ฐ’ ์ž…๋ ฅ)
์š”์ฒญ ํŒŒ๋ผ๋ฏธํ„ฐ์˜ Type ๋ณด๋Š” ๋ฐฉ๋ฒ•์— ๋Œ€ํ•ด ๋” ์ž์„ธํžˆ ์•Œ์•„๋ณด์„ธ์š”!
Request sample
โ€ข
Header ์ •๋ณด
/* * Request HTTP URL * โ€ป๊ฒฐ์ œ์š”์ฒญ ํ›„ ๋ฆฌํ„ด๋ฐ›์€ PCD_PAY_COFURL๋กœ ์„ค์ •ํ•ด์ฃผ์„ธ์š”. * TEST : https://democpay.payple.kr/php/PayCardConfirmAct.php?ACT_=PAYM * REAL : https://cpay.payple.kr/php/PayCardConfirmAct.php?ACT_=PAYM */ Request URL: "https://democpay.payple.kr/php/PayCardConfirmAct.php?ACT_=PAYM" HTTP Method: POST Content-Type: application/json Cache-Control: no-cache Referer: http://localhost:8080
JSON
๋ณต์‚ฌ
โ€ข
Body(Payload) ๊ฐ’
{ "PCD_CST_ID":"test", "PCD_CUST_KEY": "abcd1234567890", "PCD_AUTH_KEY": "๊ฒฐ์ œ์š”์ฒญ ํ›„ ๋ฆฌํ„ด๋ฐ›์€ PCD_AUTH_KEY", "PCD_PAY_REQKEY": "๊ฒฐ์ œ์š”์ฒญ ํ›„ ๋ฆฌํ„ด๋ฐ›์€ PCD_PAY_REQKEY", "PCD_PAYER_ID": "๊ฒฐ์ œ์š”์ฒญ ํ›„ ๋ฆฌํ„ด๋ฐ›์€ PCD_PAYER_ID" }
JSON
๋ณต์‚ฌ

Response Parameters

Show All
Search
๊ฒฐ์ œ์ˆ˜๋‹จ
Parameter
๋” ์•Œ์•„๋ณด๊ธฐ
Parameter value
Reference
Type
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_RST
Open
"success"
์š”์ฒญ ๊ฒฐ๊ณผ (success, error)
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_CODE
Open
"0000"
์‘๋‹ต์ฝ”๋“œ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_MSG
Open
"์นด๋“œ๊ฒฐ์ œ์™„๋ฃŒ"
์š”์ฒญ ๊ฒฐ๊ณผ ๋ฉ”์‹œ์ง€
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_TYPE
Open
"card"
๊ฒฐ์ œ์ˆ˜๋‹จ (์นด๋“œ: card, ๊ณ„์ขŒ:transfer)
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_REQKEY
Open
"Vnx..."
(CERT๋ฐฉ์‹) ์ตœ์ข… ๊ฒฐ์ œ์š”์ฒญ ์Šน์ธํ‚ค
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_OID
Open
"ORDER_17027809"
์ฃผ๋ฌธ๋ฒˆํ˜ธ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_ID
Open
"OVA3โ€ฆ"
๋นŒ๋งํ‚ค โ€ป ์•ฑ์นด๋“œ ๊ฒฐ์ œ(PCD_CARD_VER = โ€˜02โ€™)์ธ ๊ฒฝ์šฐ, ๋นŒ๋งํ‚ค๋Š” ๋ฐ˜ํ™˜๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. - ๋นŒ๋งํ‚ค๋Š” ํŽ˜์ดํ”Œ ๊ฐ„ํŽธ๊ฒฐ์ œ๋กœ ๊ฒฐ์ œ ๋ฐ ๋“ฑ๋ก์‹œ์—๋งŒ ๋ฐ˜ํ™˜๋˜๋Š” ๊ฐ’์ž…๋‹ˆ๋‹ค.
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_NO
Open
"1234"
ํŒŒํŠธ๋„ˆ์‚ฌ์—์„œ ์‚ฌ์šฉํ•˜๋Š” ํšŒ์›๋ฒˆํ˜ธ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_NAME
Open
"ํ™๊ธธ๋™"
๊ณ ๊ฐ ์ด๋ฆ„
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_HP
Open
"01012345678"
๊ณ ๊ฐ ํœด๋Œ€์ „ํ™”๋ฒˆํ˜ธ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAYER_EMAIL
Open
"test@payple.kr"
๊ณ ๊ฐ ์ด๋ฉ”์ผ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_GOODS
Open
"ํ…Œ์ŠคํŠธ ์ƒํ’ˆ๋ช…"
์ƒํ’ˆ๋ช…
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_TOTAL
Open
"1000"
๊ฒฐ์ œ๊ธˆ์•ก
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_TAXTOTAL
Open
"0"
- ๋ณตํ•ฉ๊ณผ์„ธ(๊ณผ์„ธ+๋ฉด์„ธ) ์ฃผ๋ฌธ๊ฑด์— ํ•„์š”ํ•œ ๊ธˆ์•ก์ด๋ฉฐ, ํŒŒํŠธ๋„ˆ์‚ฌ์—์„œ ์ง€์ •ํ•˜์—ฌ ์ „์†กํ•œ ๊ฐ’์ด ๋ฆฌํ„ด๋ฉ๋‹ˆ๋‹ค. โ€ป๋ณตํ•ฉ๊ณผ์„ธ๋Š” ๊ณต๊ธ‰๊ฐ€์•ก์ด ์•„๋‹Œ ์‹ค์ œ ์‹œ๊ณ ๊ฐ€ ๋œ ๋ถ€๊ฐ€์„ธ ๊ธˆ์•ก์ด ๋ฆฌํ„ด๋ฉ๋‹ˆ๋‹ค.
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_ISTAX
Open
"Y"
๊ณผ์„ธ์„ค์ • (Default: Y ์ด๋ฉฐ, ๊ณผ์„ธ:Y, ๋ณตํ•ฉ๊ณผ์„ธ:Y, ๋น„๊ณผ์„ธ: N)
String
์นด๋“œ
๊ณ„์ขŒ
PCD_PAY_TIME
Open
"20231219134223"
๊ฒฐ์ œ์‹œ๊ฐ„
String
์นด๋“œ
PCD_PAY_CARDNAME
Open
"์‚ผ์„ฑ์นด๋“œ"
์นด๋“œ์‚ฌ๋ช…
String
์นด๋“œ
PCD_PAY_CARDNUM
Open
"1234-****-****-5678"
์นด๋“œ๋ฒˆํ˜ธ
String
์นด๋“œ
PCD_PAY_CARDTRADENUM
Open
"202312191342223302115099"
๊ฑฐ๋ž˜ ํ‚ค
String
์นด๋“œ
PCD_PAY_CARDAUTHNO
Open
"85324231"
์Šน์ธ๋ฒˆํ˜ธ
String
์นด๋“œ
PCD_PAY_CARDRECEIPT
Open
"https://www.danalpay.."
๋งค์ถœ์ „ํ‘œ ์ถœ๋ ฅ ๋งํฌ
String
์นด๋“œ
๊ณ„์ขŒ
PCD_SIMPLE_FLAG
Open
"Y"
String
๊ณ„์ขŒ
PCD_PAY_BANK
Open
"020"
์€ํ–‰์ฝ”๋“œ
String
๊ณ„์ขŒ
PCD_PAY_BANKNAME
Open
"์šฐ๋ฆฌ์€ํ–‰"
์€ํ–‰๋ช…
String
๊ณ„์ขŒ
PCD_PAY_BANKNUM
Open
"123-********-456"
๊ณ„์ขŒ๋ฒˆํ˜ธ(์ผ๋ถ€ ๋งˆ์Šคํ‚น ์ฒ˜๋ฆฌ)
String
๊ณ„์ขŒ
PCD_TAXSAVE_MGTNUM
Open
"G3482429BV2..."
ํ˜„๊ธˆ์˜์ˆ˜์ฆ ๊ตญ์„ธ์ฒญ ๋ฐœํ–‰๋ฒˆํ˜ธ - PCD_TAXSAVE_FLAG ์‚ฌ์šฉ์‹œ ์‘๋‹ต
String
๊ณ„์ขŒ
PCD_TAXSAVE_FLAG
Open
"Y"
ํ˜„๊ธˆ์˜์ˆ˜์ฆ ๋ฐœํ–‰์—ฌ๋ถ€ (๋ฐœํ–‰: Y, ๋ฏธ๋ฐœํ–‰: N)
String
๊ณ„์ขŒ
PCD_TAXSAVE_RST
Open
"Y"
ํ˜„๊ธˆ์˜์ˆ˜์ฆ ๋ฐœํ–‰๊ฒฐ๊ณผ (์„ฑ๊ณต: Y, ์‹คํŒจ: N)
String
โ€ข
์นด๋“œ๊ฒฐ์ œ(CERT) Response Sample
Response sample
{ "PCD_PAY_RST": "success" "PCD_PAY_CODE": "PCCF0000" "PCD_PAY_MSG": "์นด๋“œ๊ฒฐ์ œ์™„๋ฃŒ" "PCD_PAY_REQKEY": "d2NtOFExTVF..." "PCD_PAY_OID": "ORDER_17027809" "PCD_PAY_TYPE": "card" "PCD_PAYER_ID": "OVA3..." "PCD_PAYER_NO": "1234" "PCD_PAYER_NAME": "ํ™๊ธธ๋™" "PCD_PAYER_HP": "01012345678" "PCD_PAYER_EMAIL": "test@payple.kr" "PCD_PAY_GOODS": "ํ…Œ์ŠคํŠธ ์ƒํ’ˆ๋ช…" "PCD_PAY_AMOUNT": "1000" "PCD_PAY_AMOUNT_REAL": "1000" "PCD_PAY_TOTAL": "1000" "PCD_PAY_TAXTOTAL": "0" "PCD_PAY_ISTAX": "Y" "PCD_PAY_CARDNAME": "์‚ผ์„ฑ์นด๋“œ" "PCD_PAY_CARDNUM": "1234-****-****-5678" "PCD_PAY_CARDTRADENUM": "202312191342223302115099" "PCD_PAY_CARDAUTHNO": "85324231" "PCD_PAY_CARDRECEIPT": "https://www.danalpay.com/..." "PCD_PAY_TIME": "20231219134223" "PCD_SIMPLE_FLAG": "N" }
JSON
๋ณต์‚ฌ

4. ์ทจ์†Œ

๊ณ ๊ฐ์ด ๊ฒฐ์ œ ํ›„ ๋ณ€์‹ฌํ•˜์—ฌ ์ทจ์†Œ๋ฅผ ์›ํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.
ํŒŒํŠธ๋„ˆ๋Š” ํŽ˜์ดํ”Œ์— ์ทจ์†Œ๋ฅผ ์š”์ฒญํ•˜์—ฌ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.

4-1. ์ทจ์†Œ ํ”„๋กœ์„ธ์Šค

4-2. ํŒŒํŠธ๋„ˆ ์ธ์ฆ

ํŒŒํŠธ๋„ˆ ์„œ๋ฒ„

Request Parameters

๊ธฐ๋ณธ ๋ณด๊ธฐ
Search
Parameter
๋” ์•Œ์•„๋ณด๊ธฐ
Parameter value
Type (Length)
ํ•„์ˆ˜
Reference
cst_id
Open
"test"
aN(8)
Y
ํŒŒํŠธ๋„ˆ ID
custKey
Open
"abcd1234567890"
aN(255)
Y
ํŒŒํŠธ๋„ˆ ์ธ์ฆํ‚ค
PCD_PAYCANCEL_FLAG
Open
"Y"
A(1)
Y
์ทจ์†Œ ์š”์ฒญ Parameter
COUNT3
์š”์ฒญ ํŒŒ๋ผ๋ฏธํ„ฐ์˜ Type ๋ณด๋Š” ๋ฐฉ๋ฒ•์— ๋Œ€ํ•ด ๋” ์ž์„ธํžˆ ์•Œ์•„๋ณด์„ธ์š”!
Request sample
โ€ข
Header ์ •๋ณด
/* * Request HTTP URL * TEST : https://democpay.payple.kr/php/auth.php * REAL : https://cpay.payple.kr/php/auth.php */ Request URL: "https://democpay.payple.kr/php/auth.php" HTTP Method: POST Content-Type: application/json Cache-Control: no-cache Referer: https://ํŒŒํŠธ๋„ˆ์‚ฌ ๋„๋ฉ”์ธ /* โ€ป Referer ์„ค์ • ๋ฐฉ๋ฒ• * REAL : referer์—๋Š” ํŒŒํŠธ๋„ˆ์‚ฌ ๋„๋ฉ”์ธ์œผ๋กœ ๋“ฑ๋ก๋œ ๋„๋ฉ”์ธ์„ ๋„ฃ์–ด์ฃผ์…”์•ผํ•ฉ๋‹ˆ๋‹ค. * ๋‹ค๋ฅธ ๋„๋ฉ”์ธ์„ ๋„ฃ์œผ์‹œ๋ฉด [AUTH0004] ์‘๋‹ต์ด ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค. */
JSON
๋ณต์‚ฌ
Referer์— ๋Œ€ํ•œ ์ž์„ธํ•œ ์„ค๋ช…์€ ์ด๊ณณ์—์„œ ํ™•์ธํ•ด๋ณด์„ธ์š”!
โ€ข
Body(Payload) ๊ฐ’
{ "cst_id": "test", "custKey": "abcd1234567890", "PCD_PAYCANCEL_FLAG": "Y" }
JSON
๋ณต์‚ฌ
PHP ์ƒ˜ํ”Œ์ฝ”๋“œ
JAVA ์ƒ˜ํ”Œ์ฝ”๋“œ
NODE ์ƒ˜ํ”Œ์ฝ”๋“œ

Response Parameters

โ€ข
ํŒŒํŠธ๋„ˆ ์ธ์ฆ์ด ์„ฑ๊ณตํ•˜๋ฉด ํŽ˜์ดํ”Œ์—์„œ ํŒŒํŠธ๋„ˆ์— ๋‹ค์Œ๊ณผ ๊ฐ™์€ ์„ฑ๊ณต ๋ฆฌํ„ด์„ ๋“œ๋ฆฝ๋‹ˆ๋‹ค.
๊ธฐ๋ณธ ๋ณด๊ธฐ
Search
Parameter
๋” ์•Œ์•„๋ณด๊ธฐ
Parameter value
Reference
Type
server_name
Open
"democpay.payple.kr"
ํŒŒํŠธ๋„ˆ ์ธ์ฆ์‹œ ํŽ˜์ดํ”Œ์˜ ์š”์ฒญ URL
String
result
Open
"success"
๊ฒฐ๊ณผํ™•์ธ
String
result_msg
Open
"์‚ฌ์šฉ์ž ์ธ์ฆ ์™„๋ฃŒ!!"
๊ฒฐ๊ณผ๋ฉ”์„ธ์ง€
String
cst_id
Open
"UFVNNVZ..."
ํŒŒํŠธ๋„ˆ ID
String
custKey
Open
"T3JzRkp5L..."
ํŒŒํŠธ๋„ˆ Key
String
AuthKey
Open
"a688ccb3555..."
ํŒŒํŠธ๋„ˆ ์ธ์ฆํ† ํฐ
String
PCD_PAY_HOST
Open
"https://democpay.payple.kr"
๊ฒฐ์ œ์š”์ฒญ ๋„๋ฉ”์ธ
String
PCD_PAY_URL
Open
"<return_uri>"
๊ฒฐ์ œ์š”์ฒญ URI *๊ณ ์ •๊ฐ’์œผ๋กœ ์‚ฌ์šฉํ•˜์ง€ ์•Š๊ธฐ๋ฅผ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค.
String
return_url
Open
"<return full uri>"
๊ฒฐ์ œ์š”์ฒญ URI (PCD_PAY_HOST + PCD_PAY_URL) *์š”์ฒญ์‹œ Request URL *๊ณ ์ •๊ฐ’์œผ๋กœ ์‚ฌ์šฉํ•˜์ง€ ์•Š๊ธฐ๋ฅผ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค.
String
COUNT9
Response sample
{ "server_name": "์š”์ฒญ URL", "result": "๊ฒฐ๊ณผํ™•์ธ", "result_msg": "๊ฒฐ๊ณผ ๋ฉ”์‹œ์ง€", "cst_id": "ํŒŒํŠธ๋„ˆ์‚ฌ ์•„์ด๋””", "custKey": "ํŒŒํŠธ๋„ˆ์‚ฌ ํ‚ค", "AuthKey": "ํŒŒํŠธ๋„ˆ์‚ฌ ์ธ์ฆํ† ํฐ", "PCD_PAY_HOST": "์š”์ฒญ ๋„๋ฉ”์ธ, (์˜ˆ: https://democpay.payple.kr)", "PCD_PAY_URL": "์š”์ฒญ URL, (์˜ˆ: /auth.php)", "return_url": "์š”์ฒญ URL (PCD_PAY_HOST + PCD_PAY_URL)" }
JSON
๋ณต์‚ฌ
์‹คํŒจ ๋ฆฌํ„ด (result = error)์„ ๋ฐ›์œผ์‹  ๊ฒฝ์šฐ, result_msg ์˜ ์‘๋‹ต์ฝ”๋“œ๋ฅผ ํ™•์ธํ•˜๊ณ  ์ž˜๋ชป๋œ ๋ถ€๋ถ„์„ ์ˆ˜์ •ํ•ฉ๋‹ˆ๋‹ค. ์‘๋‹ต์ฝ”๋“œ ๋ฆฌ์ŠคํŠธ๋Š” ์ด ๊ณณ ์—์„œ ํ™•์ธํ•˜์‹ค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

4-3. ๊ฒฐ์ œ ์ทจ์†Œ ์š”์ฒญ

ํŒŒํŠธ๋„ˆ ์„œ๋ฒ„
โ€ข
ํŒŒํŠธ๋„ˆ๋Š” ํŒŒํŠธ๋„ˆ ์ธ์ฆ ์™„๋ฃŒ ํ›„ ์ทจ์†Œ ์š”์ฒญ์„ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค.
โ€ข
์ด๋•Œ ํŒŒํŠธ๋„ˆ ์ธ์ฆ ํ›„ Response ๋ฐ›์€ cst_id, custKey, AuthKey ๊ฐ’์„ ๊ฐ๊ฐ PCD_CST_ID, PCD_CUST_KEY, PCD_AUTH_KEY ์— ๋„ฃ์–ด ์š”์ฒญ์„ ๋ณด๋‚ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
ํŒŒํŠธ๋„ˆ ์ธ์ฆ ํ›„ Response ๋ฐ›์€ cst_id, custKey,AuthKey ๊ฐ’์€ ๊ณ ์ •๊ฐ’์ด ์•„๋‹ˆ๋ฏ€๋กœ ์ €์žฅํ•ด๋†“๊ณ  ๊ณ„์†ํ•ด์„œ ์‚ฌ์šฉํ•˜๋ฉด ์•ˆ๋ฉ๋‹ˆ๋‹ค. + ํ•œ ๋ฒˆ์˜ ํŒŒํŠธ๋„ˆ ์ธ์ฆ๊ณผ ํ•˜๋‚˜์˜ ์š”์ฒญ์ด ๋งค์นญ๋˜์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์ฆ‰, ํ•œ ๋ฒˆ์˜ ํŒŒํŠธ๋„ˆ ์ธ์ฆ์œผ๋กœ ๋ฐ›์€ cst_id, custKey,AuthKey ๊ฐ’์„ ์—ฌ๋Ÿฌ ์š”์ฒญ์— ์‚ฌ์šฉํ•˜๋ฉด ์•ˆ๋ฉ๋‹ˆ๋‹ค.
ํŒŒํŠธ๋„ˆ ์ธ์ฆ์š”์ฒญ ํ›„ API ์š”์ฒญ์€ 30๋ถ„์ด๋‚ด๋กœ ์ง„ํ–‰ํ•ด์ฃผ์‹œ๊ธฐ ๋ฐ”๋ž๋‹ˆ๋‹ค.

Request Parameters

๊ธฐ๋ณธ ๋ณด๊ธฐ
Search
Parameter
๋” ์•Œ์•„๋ณด๊ธฐ
Parameter value
Type (Length)
ํ•„์ˆ˜
Reference
PCD_CST_ID
Open
"UFVN..."
aN(255)
Y
ํŒŒํŠธ๋„ˆ ์ธ์ฆ ํ›„ ๋ฆฌํ„ด ๋ฐ›์€ cst_id Token
PCD_CUST_KEY
Open
"T3Jz..."
aN(255)
Y
ํŒŒํŠธ๋„ˆ ์ธ์ฆ ํ›„ ๋ฆฌํ„ด ๋ฐ›์€ custKey Token
PCD_AUTH_KEY
Open
"a688c..."
aNS(255)
Y
ํŒŒํŠธ๋„ˆ ์ธ์ฆ ํ›„ ๋ฆฌํ„ด ๋ฐ›์€ ์ธ์ฆ Token
PCD_REFUND_KEY
Open
"a41c..."
aN
Y
ํ™˜๋ถˆ์„œ๋น„์Šค Key (ํŒŒํŠธ๋„ˆ ๊ด€๋ฆฌ์ž > ์ƒ์ ์ •๋ณด > ๊ธฐ๋ณธ์ •๋ณด์—์„œ ํ™•์ธํ•˜์‹ค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.)
PCD_PAYCANCEL_FLAG
Open
"Y"
A(1)
Y
โ€˜Yโ€™ - ๊ณ ์ •๊ฐ’
PCD_PAY_OID
Open
"ORDER_17027809"
aN(255)
Y
์›๊ฑฐ๋ž˜ ์ฃผ๋ฌธ๋ฒˆํ˜ธ
PCD_PAY_DATE
Open
"20231219"
N(8)
Y
์ทจ์†Œ ๋Œ€์ƒ ๊ฑฐ๋ž˜๊ฑด์ด ๊ฒฐ์ œ๋œ ์›๊ฑฐ๋ž˜์ผ์ž
PCD_REFUND_TOTAL
Open
"1000"
N(10)
Y
๊ฒฐ์ œ์ทจ์†Œ ์š”์ฒญ๊ธˆ์•ก (๊ธฐ์กด ๊ฒฐ์ œ๊ธˆ์•ก๋ณด๋‹ค ์ ์€ ๊ธˆ์•ก ์ž…๋ ฅ ์‹œ ๋ถ€๋ถ„์ทจ์†Œ๋กœ ์ง„ํ–‰)
PCD_REFUND_TAXTOTAL
Open
"10"
N(9)
N
๋ณตํ•ฉ๊ณผ์„ธ(๊ณผ์„ธ+๋ฉด์„ธ) ๊ฑฐ๋ž˜๊ฑด์„ ์ทจ์†Œํ• ๋•Œ๋Š” PCD_REFUND_TAXTOTAL ์— ์ทจ์†Œํ•  ๊ณผ์„ธ๊ธˆ์•ก์„ ๋ณ„๋„๋กœ ์ง€์ •ํ•ด์„œ ์ทจ์†Œ์š”์ฒญ์„ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค.
COUNT9
์š”์ฒญ ํŒŒ๋ผ๋ฏธํ„ฐ์˜ Type ๋ณด๋Š” ๋ฐฉ๋ฒ•์— ๋Œ€ํ•ด ๋” ์ž์„ธํžˆ ์•Œ์•„๋ณด์„ธ์š”!
Request sample
โ€ข
Header ์ •๋ณด
/* * ๊ฒฐ์ œ์ทจ์†Œ ์š”์ฒญ * Request HTTP URL * โ€ปํŒŒํŠธ๋„ˆ ์ธ์ฆ ํ›„ ๋ฆฌํ„ด๋ฐ›์€ return_url๋กœ ์„ค์ •ํ•ด์ฃผ์„ธ์š”. * (return_url = PCD_PAY_HOST + PCD_PAY_URL) * TEST : https://democpay.payple.kr/(ํŒŒํŠธ๋„ˆ ์ธ์ฆ ํ›„ ๋ฆฌํ„ด ๋ฐ›์€ ์š”์ฒญ URL(PCD_PAY_URL)) * REAL : https://cpay.payple.kr/(ํŒŒํŠธ๋„ˆ ์ธ์ฆ ํ›„ ๋ฆฌํ„ด ๋ฐ›์€ ์š”์ฒญ URL(PCD_PAY_URL)) */ Request URL: "https://democpay.payple.kr/(ํŒŒํŠธ๋„ˆ ์ธ์ฆํ›„ ๋ฆฌํ„ด๋ฐ›์€ PCD_PAY_URL)" HTTP Method: POST Content-Type: application/json Cache-Control: no-cache Referer: http://localhost:8080
JSON
๋ณต์‚ฌ
โ€ข
Body(Payload) ๊ฐ’
{ "PCD_CST_ID" : "ํŒŒํŠธ๋„ˆ ์ธ์ฆ ํ›„ ๋ฆฌํ„ด๋ฐ›์€ cst_id", "PCD_CUST_KEY" : "ํŒŒํŠธ๋„ˆ ์ธ์ฆ ํ›„ ๋ฆฌํ„ด๋ฐ›์€ custKey", "PCD_AUTH_KEY" : "ํŒŒํŠธ๋„ˆ ์ธ์ฆ ํ›„ ๋ฆฌํ„ด๋ฐ›์€ AuthKey", "PCD_REFUND_KEY" : "a41ce010e...", "PCD_PAYCANCEL_FLAG": "Y", "PCD_PAY_OID": "ORDER_17027809", "PCD_PAY_DATE": "20231219", "PCD_REFUND_TOTAL": "1000" }
JSON
๋ณต์‚ฌ

Response Parameters

๊ธฐ๋ณธ ๋ณด๊ธฐ
Search
Parameter
๋” ์•Œ์•„๋ณด๊ธฐ
๊ฒฐ์ œ์ˆ˜๋‹จ
Parameter value
Reference
Type
PCD_PAY_RST
Open
์นด๋“œ
๊ณ„์ขŒ
"success"
์š”์ฒญ ๊ฒฐ๊ณผ(success, error)
String
PCD_PAY_CODE
Open
์นด๋“œ
๊ณ„์ขŒ
"PAYC0000"
๊ฒฐ๊ณผ์ฝ”๋“œ
String
PCD_PAY_MSG
Open
์นด๋“œ
๊ณ„์ขŒ
"ํ™˜๋ถˆ์„ฑ๊ณต"
๊ฒฐ๊ณผ ๋ฉ”์‹œ์ง€
String
PCD_PAY_OID
Open
์นด๋“œ
๊ณ„์ขŒ
"ORDER_17027809"
์ฃผ๋ฌธ๋ฒˆํ˜ธ
String
PCD_PAY_TYPE
Open
์นด๋“œ
๊ณ„์ขŒ
"card"
๊ฒฐ์ œ์ˆ˜๋‹จ - ์นด๋“œ: card - ๊ณ„์ขŒ์ด์ฒด: transfer
String
PCD_PAYER_ID
Open
์นด๋“œ
๊ณ„์ขŒ
"OVA3โ€ฆ"
์นด๋“œ ๋ฐ ๊ณ„์ขŒ ๋“ฑ๋ก ํ›„ ๋ฆฌํ„ด๋ฐ›์€ ๋นŒ๋งํ‚ค
String
PCD_PAY_GOODS
Open
์นด๋“œ
๊ณ„์ขŒ
"ํ…Œ์ŠคํŠธ ์ƒํ’ˆ๋ช…"
์ƒํ’ˆ๋ช…
String
PCD_REFUND_TOTAL
Open
์นด๋“œ
๊ณ„์ขŒ
"1000"
ํ™˜๋ถˆ๊ธˆ์•ก
String
PCD_REFUND_TAXTOTAL
Open
์นด๋“œ
๊ณ„์ขŒ
"10"
๊ณผ์„ธ ๋ฐ ๋ณตํ•ฉ๊ณผ์„ธ(๊ณผ์„ธ+๋ฉด์„ธ) ์ฃผ๋ฌธ๊ฑด์— ํ•„์š”ํ•œ ๊ธˆ์•ก์ด๋ฉฐ ํŒŒํŠธ๋„ˆ์‚ฌ์—์„œ ์ „์†กํ•œ ๊ฐ’์„ ๋ถ€๊ฐ€์„ธ๋กœ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค. ๋น„๊ณผ์„ธ์˜ ๊ฒฝ์šฐ ์‚ฌ์šฉํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
String
PCD_PAY_CARDTRADENUM
Open
์นด๋“œ
"20231..."
์นด๋“œ ์Šน์ธ์ทจ์†Œ ๊ฑฐ๋ž˜ ํ‚ค
String
PCD_PAY_CARDRECEIPT
Open
์นด๋“œ
"https://..."
๋งค์ถœ์ „ํ‘œ ์ถœ๋ ฅ ๋งํฌ
String
PCD_PAY_TIME
Open
์นด๋“œ
๊ณ„์ขŒ
"20231219134223โ€
์ทจ์†Œ์‹œ๊ฐ„
String
COUNT12
โ€ข
์นด๋“œ ์ทจ์†Œ ์‘๋‹ต ์˜ˆ์‹œ
Response sample
{ "PCD_PAY_RST": "success", "PCD_PAY_CODE": "PAYC0000", "PCD_PAY_MSG": "์Šน์ธ์ทจ์†Œ์„ฑ๊ณต", "PCD_PAY_OID": "ORDER_17027809", "PCD_PAY_TYPE": "card", "PCD_PAYER_ID": "OVA3...", "PCD_PAY_GOODS": "ํ…Œ์ŠคํŠธ ์ƒํ’ˆ๋ช…", "PCD_REFUND_TOTAL": "1000", "PCD_REFUND_TAXTOTAL": "10", "PCD_PAY_TIME": "20231219134223", "PCD_PAY_CARDTRADENUM": "20231...", "PCD_PAY_CARDRECEIPT": "https://..." }
JSON
๋ณต์‚ฌ
โ€ข
๊ณ„์ขŒ์ด์ฒด ์ทจ์†Œ ์‘๋‹ต ์˜ˆ์‹œ
Response sample
{ "PCD_PAY_RST": "success", "PCD_PAY_CODE": "PAYC0000", "PCD_PAY_MSG": "ํ™˜๋ถˆ์„ฑ๊ณต", "PCD_PAY_OID": "ORDER_17027809", "PCD_PAY_TYPE": "transfer", "PCD_PAYER_ID": "NS9qNTgzU2xRNH...", "PCD_PAY_GOODS": "ํ…Œ์ŠคํŠธ ์ƒํ’ˆ๋ช…", "PCD_REFUND_TOTAL": "1000", "PCD_REFUND_TAXTOTAL": "10", "PCD_PAY_TIME": "20231219134223", "PCD_TAXSAVE_RST": "0000", "PCD_TAXSAVE_MSG": "ํ˜„๊ธˆ์˜์ˆ˜์ฆ ๋ฐœํ–‰์ทจ์†Œ ์„ฑ๊ณต", }
JSON
๋ณต์‚ฌ
PCD_PAY_RST = success, PCD_PAY_CODE = "0000"์ด ํฌํ•จ๋  ๊ฒฝ์šฐ ์š”์ฒญ์„ฑ๊ณต์œผ๋กœ ํŒ๋‹จํ•ฉ๋‹ˆ๋‹ค. PCD_PAY_RST = error ์ผ ๊ฒฝ์šฐ ์š”์ฒญ์‹คํŒจ๋กœ ํŒ๋‹จํ•ฉ๋‹ˆ๋‹ค.
์‹คํŒจ ๋ฆฌํ„ด(PCD_PAY_RST = error )์„ ๋ฐ›์œผ์‹  ๊ฒฝ์šฐ, PCD_PAY_MSG ์˜ ์‘๋‹ต์ฝ”๋“œ๋ฅผ ํ™•์ธํ•˜๊ณ  ์ž˜๋ชป๋œ ๋ถ€๋ถ„์„ ์ˆ˜์ •ํ•ฉ๋‹ˆ๋‹ค. ์‘๋‹ต์ฝ”๋“œ ๋ฆฌ์ŠคํŠธ๋Š” ์ด ๊ณณ ์—์„œ ํ™•์ธํ•˜์‹ค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

5. ๋งˆ๋ฌด๋ฆฌ

โ€ข
์ผํšŒ์„ฑ ๊ฐ„ํŽธ๊ฒฐ์ œ์˜ ๊ฒฐ์ œ๋ถ€ํ„ฐ ์ทจ์†Œ๊นŒ์ง€์˜ ์—ฐ๋™์ž‘์—…์„ ์™„๋ฃŒํ•˜์˜€์Šต๋‹ˆ๋‹ค! ์ถ•ํ•˜๋“œ๋ฆฝ๋‹ˆ๋‹ค!

5-1. ์ด์ œ ๋‹ค๋ฅธ ๊ฒฐ์ œ๋ฐฉ์‹ ์—ฐ๋™๋ฐฉ๋ฒ•๋„ ํ™•์ธํ•ด๋ณด์„ธ์š”.

์นด๋“œ ๊ณ„์ขŒ ์ •๊ธฐ๊ฒฐ์ œ
๊ณ ๊ฐ์—๊ฒŒ ์ตœ์ดˆ 1ํšŒ ์นด๋“œ/๊ณ„์ขŒ ์ •๋ณด ๋“ฑ๋ก๋งŒ ๋ฐ›๊ณ , ํŒŒํŠธ๋„ˆ์‚ฌ์˜ ๋‹ค์–‘ํ•œ ๊ฒฐ์ œ์ฃผ๊ธฐ์— ๋งž์ถฐ ์ž๋™์œผ๋กœ ๊ฒฐ์ œ๋ฅผ ๋ฐ›์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
์นด๋“œ ์•ฑ์นด๋“œ ๊ฒฐ์ œ
์นด๋“œ์‚ฌ์—์„œ ์ œ๊ณตํ•˜๋Š” ์•ฑ์นด๋“œ๋กœ ๊ฒฐ์ œํ•˜๋Š” ๋ฐฉ์‹์ž…๋‹ˆ๋‹ค. ํ• ๋ถ€ ์„œ๋น„์Šค๊ฐ€ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.
์นด๋“œ ๊ณ„์ขŒ URL๋งํฌ๊ฒฐ์ œ
๊ฐœ๋ฐœ์—ฐ๋™์ด ํ•„์š”์—†์ด ํŒŒํŠธ๋„ˆ ๊ด€๋ฆฌ์ž์—์„œ ๋งํฌ๋ฅผ ์ƒ์„ฑํ•ด ๊ฒฐ์ œ๋ฅผ ๋ฐ›์„ ์ˆ˜ ์žˆ๋Š” ์„œ๋น„์Šค์ž…๋‹ˆ๋‹ค.
์นด๋“œ ๊ณ„์ขŒ ๋น„๋ฐ€๋ฒˆํ˜ธ ๊ฐ„ํŽธ๊ฒฐ์ œ
6์ž๋ฆฌ ๋น„๋ฐ€๋ฒˆํ˜ธ๋ฅผ ์„ค์ •ํ•˜๊ณ  ์žฌ๊ฒฐ์ œ์‹œ ๋น„๋ฐ€๋ฒˆํ˜ธ๋ฅผ ์ธ์ฆ๋ฐ›์•„ ๊ฒฐ์ œ๋ฅผ ์ฒ˜๋ฆฌํ•˜๋Š” ์„œ๋น„์Šค์ž…๋‹ˆ๋‹ค.

5-2. ๊ธฐํƒ€ API ํ™œ์šฉ๋ฐฉ๋ฒ•๋„ ํ™•์ธํ•ด๋ณด์„ธ์š”.

์นด๋“œ ๊ณ„์ขŒ ๊ฒฐ์ œ๊ฒฐ๊ณผ ์กฐํšŒ
๊ฑฐ๋ž˜๊ฑด์˜ ๊ฒฐ์ œ๊ฒฐ๊ณผ๋ฅผ ํ™•์ธํ•˜๋Š” API์ž…๋‹ˆ๋‹ค.
์นด๋“œ ๊ณ„์ขŒ ๋“ฑ๋ก ์กฐํšŒ
์žฌ๊ฒฐ์ œ๋ฅผ ์œ„ํ•ด ๋“ฑ๋กํ–ˆ๋˜ ์นด๋“œ/๊ณ„์ขŒ์˜ ๋นŒ๋งํ‚ค(PCD_PAYER_ID)์˜ ์ƒํƒœ๋ฅผ ์กฐํšŒํ•˜๋Š” API์ž…๋‹ˆ๋‹ค.
์นด๋“œ ๊ณ„์ขŒ ๋“ฑ๋ก ํ•ด์ง€
์žฌ๊ฒฐ์ œ๋ฅผ ์œ„ํ•ด ๋“ฑ๋กํ–ˆ๋˜ ์นด๋“œ/๊ณ„์ขŒ์˜ ๋นŒ๋งํ‚ค(PCD_PAYER_ID)๋ฅผ ํ•ด์ง€ํ•˜๋Š” API์ž…๋‹ˆ๋‹ค.
๊ณ„์ขŒ ํ˜„๊ธˆ์˜์ˆ˜์ฆ ๋ฐœํ–‰
๊ณ„์ขŒ์ด์ฒด๋กœ ๊ฒฐ์ œ๊ฐ€ ๋ฐœ์ƒํ•œ ๊ฑฐ๋ž˜์˜ ํ˜„๊ธˆ์˜์ˆ˜์ฆ์„ ๊ฐœ๋ณ„์ ์œผ๋กœ ๋ฐœํ–‰ํ•˜๋Š” API์ž…๋‹ˆ๋‹ค.
๊ณ„์ขŒ ํ˜„๊ธˆ์˜์ˆ˜์ฆ ์ทจ์†Œ๋ฐœํ–‰
๊ณ„์ขŒ์ด์ฒด๋กœ ๊ฒฐ์ œ๊ฐ€ ๋ฐœ์ƒํ•œ ๊ฑฐ๋ž˜์˜ ํ˜„๊ธˆ์˜์ˆ˜์ฆ์„ ๊ฐœ๋ณ„์ ์œผ๋กœ ์ทจ์†Œ๋ฐœํ–‰ํ•˜๋Š” API์ž…๋‹ˆ๋‹ค.