concept_auth_and_approve - nicepayments/nicepay-manual GitHub Wiki

์ธ์ฆ ๋ฐ ์Šน์ธ์— ๋Œ€ํ•œ ๊ฐœ๋… ์ดํ•ดํ•˜๊ธฐ

๊ฐ€๋งน์  ์ž…์žฅ์—์„œ๋Š” ๊ฒฐ์ œ๋ผ๋Š” ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•˜๊ธฐ ์œ„ํ•ด์„œ ๊ฒฐ์ œ ๋Œ€ํ–‰์‚ฌ์—์„œ ์ œ๊ณตํ•˜๋Š” ์ธ์ฆ / ์Šน์ธ ์š”์ฒญ์„ ํ•˜๋‚˜์˜ ๊ธฐ๋Šฅ์œผ๋กœ ๊ฐœ๋ฐœํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์ธ์ฆ (๊ฒฐ์ œ์ฐฝ)

๊ฐ€๋งน์ ์—์„œ ์ƒํ’ˆ ๋˜๋Š” ์„œ๋น„์Šค๋ฅผ ํŒ๋งคํ•  ๋•Œ, ๊ณ ๊ฐ์€ ๊ฒฐ์ œ์ฐฝ์„ ํ†ตํ•ด ๊ฒฐ์ œ์ˆ˜๋‹จ๊ณผ ๊ธˆ์•ก์„ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค. ๊ฐ€๋งน์ ์€ ์ด ์ •๋ณด๋ฅผ ๊ฒฐ์ œ๋Œ€ํ–‰์‚ฌ์—๊ฒŒ ๋ณด๋ƒ…๋‹ˆ๋‹ค.

๊ฒฐ์ œ๋Œ€ํ–‰์‚ฌ๋Š” ์นด๋“œ์‚ฌ์™€ ํ˜‘๋ ฅํ•˜์—ฌ ๊ณ ๊ฐ์˜ ๊ฒฐ์ œ์ˆ˜๋‹จ์ด ์œ ํšจํ•œ์ง€ ํ™•์ธํ•œ ํ›„, ๊ทธ ๊ฒฐ๊ณผ๋ฅผ ๊ฐ€๋งน์ ์— ์•Œ๋ ค์ค๋‹ˆ๋‹ค. ์ด๋•Œ, ๋‚˜์ด์ŠคํŽ˜์ด๋จผ์ธ  ๊ฐ™์€ ๊ฒฐ์ œ๋Œ€ํ–‰์‚ฌ๋Š” ๊ฐ€๋งน์ ์ด ๋ฏธ๋ฆฌ ์ง€์ •ํ•œ returnUrl๋กœ ์ธ์ฆ ๊ฒฐ๊ณผ๋ฅผ ๋ณด๋ƒ…๋‹ˆ๋‹ค.

๊ฐ€๋งน์ ์€ ์ด ์ธ์ฆ ๊ฒฐ๊ณผ๋ฅผ ๋ฐ›์•„์„œ ๋‹ค์Œ ๋‹จ๊ณ„์ธ ๊ฒฐ์ œ ์Šน์ธ ๊ณผ์ •์„ ์ง„ํ–‰ํ•˜๊ฑฐ๋‚˜, ๋งŒ์•ฝ ์ธ์ฆ์— ์‹คํŒจํ–ˆ๋‹ค๋ฉด ์ ์ ˆํ•œ ์ฒ˜๋ฆฌ๋ฅผ ํ•˜๊ฒŒ ๋ฉ๋‹ˆ๋‹ค.

์ด๋Ÿฌํ•œ ์ธ์ฆ ๊ณผ์ •์€ ๊ฐ€๋งน์ ์—์„œ ์ด๋ฃจ์–ด์ง€๋Š” ๊ฒฐ์ œ๊ฐ€ ์˜ฌ๋ฐ”๋ฅด๊ณ  ์•ˆ์ „ํ•˜๊ฒŒ ์ง„ํ–‰๋  ์ˆ˜ ์žˆ๋„๋ก ์ค‘์š”ํ•œ ์—ญํ• ์„ ํ•˜๋ฉฐ, ๊ณ ๊ฐ์˜ ๊ฒฐ์ œ์ˆ˜๋‹จ์˜ ์œ ํšจ์„ฑ์„ ํ™•์ธํ•˜๋Š” ์ค‘๊ฐ„ ๋‹จ๊ณ„๋กœ ๋ณผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์Šน์ธ (๊ฒฐ์ œ)

์ธ์ฆ ๊ณผ์ •์ด ์„ฑ๊ณต์ ์œผ๋กœ ์™„๋ฃŒ๋˜๋ฉด, ๊ฐ€๋งน์ ์€ ๋‹ค์Œ ๋‹จ๊ณ„์ธ ์Šน์ธ ๊ตฌ๊ฐ„์œผ๋กœ ๋„˜์–ด๊ฐ‘๋‹ˆ๋‹ค. ์ด ๋‹จ๊ณ„๋Š” ๊ณ ๊ฐ์˜ ๊ฒฐ์ œ๋ฅผ ์ตœ์ข… ํ™•์ •ํ•˜๋Š” ๋‹จ๊ณ„๋กœ, ์นด๋“œ์‚ฌ ๋˜๋Š” ์€ํ–‰์—๊ฒŒ ์‹ค์ œ ๊ฒฐ์ œ ๊ธˆ์•ก์„ ์ฒญ๊ตฌํ•˜๋Š” ๊ณผ์ •์„ ํฌํ•จํ•ฉ๋‹ˆ๋‹ค.

๊ฐ€๋งน์ ์—์„œ๋Š” ๊ณ ๊ฐ์˜ ๊ฒฐ์ œ ์ •๋ณด์™€ ๊ธˆ์•ก์„ ์นด๋“œ์‚ฌ ์ธก์œผ๋กœ ์ „๋‹ฌํ•˜๋ฉฐ, "์ด ๊ฑฐ๋ž˜๋ฅผ ์Šน์ธํ•ด์ฃผ์„ธ์š”"๋ผ๊ณ  ์š”์ฒญํ•˜๊ฒŒ ๋ฉ๋‹ˆ๋‹ค. ์นด๋“œ์‚ฌ๋‚˜ ์€ํ–‰์€ ์ด ์š”์ฒญ์„ ๋ฐ›๊ณ  ๊ณ ๊ฐ์˜ ๊ณ„์ขŒ์—์„œ ๊ฒฐ์ œ ๊ธˆ์•ก์„ ๋นผ๋‚ด๋Š” ์ž‘์—…์„ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.

์ด๋ ‡๊ฒŒ ์Šน์ธ ๊ณผ์ •์€ ๊ณ ๊ฐ์˜ ๊ฒฐ์ œ์ˆ˜๋‹จ์ด ์œ ํšจํ•˜๋‹ค๋Š” ๊ฒƒ์„ ํ™•์ธํ•œ ์ธ์ฆ ๋‹จ๊ณ„ ๋‹ค์Œ์— ์ด๋ฃจ์–ด์ง€๋ฉฐ, ์‹ค์ œ๋กœ ๊ฒฐ์ œ ๊ธˆ์•ก์ด ๊ณ ๊ฐ์˜ ๊ณ„์ขŒ์—์„œ ๋น ์ ธ๋‚˜๊ฐ€๋Š” ๊ตฌ๊ฐ„์ž…๋‹ˆ๋‹ค.

๊ฐ„๋‹จํ•˜๊ฒŒ ๋งํ•˜์ž๋ฉด, ์ธ์ฆ์€ "์ด ์นด๋“œ๋‚˜ ๊ณ„์ขŒ๋Š” ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋Š” ๊ฑด๊ฐ€์š”?"๋ผ๊ณ  ๋ฌป๋Š” ๋‹จ๊ณ„๊ณ , ์Šน์ธ์€ "๊ทธ๋Ÿผ ์ด์ œ ์ด ์นด๋“œ๋‚˜ ๊ณ„์ขŒ์—์„œ ๋ˆ์„ ๋นผ๋„ ๋˜๊ฒ ๋„ค์š”!"๋ผ๊ณ  ๊ฒฐ์ •ํ•˜๋Š” ๋‹จ๊ณ„๋ผ๊ณ  ๋ณผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๊ฐ€๋งน์ ์—์„œ๋Š” ์ด ์Šน์ธ ๋‹จ๊ณ„๋ฅผ ํ†ตํ•ด ๊ฑฐ๋ž˜๊ฐ€ ์„ฑ๋ฆฝ๋˜๊ณ , ๊ณ ๊ฐ์˜ ๊ฒฐ์ œ๊ฐ€ ์™„๋ฃŒํ•˜๋Š” ๊ฒƒ์œผ๋กœ ์ดํ•ดํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ธ์ฆ & ์Šน์ธ ๊ตฌ๊ฐ„์ด ๋ถ„๋ฆฌ๋˜์–ด ์žˆ๋Š” ์ด์œ ?

์ธ์ฆ๊ณผ ์Šน์ธ์ด๋ผ๋Š” ๊ฐœ๋… ๋ฐ ๊ธฐ๋Šฅ์„ ๊ตฌ๋ถ„ํ•˜์—ฌ ์ œ๊ณตํ•จ์œผ๋กœ์จ ์–ป๋Š” ์ด์ ์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

๋ณด์•ˆ ๊ฐ•ํ™”

๊ณ ๊ฐ์ด ์นด๋“œ ์ •๋ณด๋ฅผ ์ž…๋ ฅํ•˜๋ฉด ๊ฐ€๋งน์ ์€ ์ด ์ •๋ณด๊ฐ€ ์˜ฌ๋ฐ”๋ฅธ์ง€ ํ™•์ธํ•˜๊ธฐ ์œ„ํ•ด ๊ฒฐ์ œ ๋Œ€ํ–‰์‚ฌ๋‚˜ ์นด๋“œ์‚ฌ์™€ ํ˜‘๋ ฅํ•˜์—ฌ ๊ณ ๊ฐ์˜ ๊ฒฐ์ œ์ˆ˜๋‹จ์˜ ์œ ํšจ์„ฑ์„ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. ๋งŒ์•ฝ ์ค‘๊ฐ„์— ๊ณต๊ฒฉ์ž๊ฐ€ ์ •๋ณด๋ฅผ ๊ฐ€๋กœ์ฑ„ ๊ณ ๊ฐ์˜ ์ •๋ณด๋ฅผ ๋„์šฉํ•˜๋ ค๊ณ  ํ•ด๋„, ๊ทธ ์ •๋ณด๋งŒ์œผ๋กœ๋Š” ์‹ค์ œ ๊ฒฐ์ œ๋ฅผ ์™„๋ฃŒํ•  ์ˆ˜ ์—†๊ฒŒ ๋ฉ๋‹ˆ๋‹ค. ์ฆ‰, ์ •๋ณด๋งŒ ํ™•์ธํ•˜๋Š” ๋‹จ๊ณ„์™€ ์‹ค์ œ ๋ˆ์„ ๋บ„ ์ˆ˜ ์žˆ๋Š” ๋‹จ๊ณ„๋ฅผ ๋”ฐ๋กœ ๋‘์–ด ๊ฐ€๋งน์ ๊ณผ ๊ณ ๊ฐ์˜ ๋ณด์•ˆ์„ ๋”์šฑ ๊ฐ•ํ™”ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

ํšจ์œจ์„ฑ ๋ฐ ์œ ์—ฐ์„ฑ

๊ณ ๊ฐ ์ž…์žฅ์—์„œ ๊ฒฐ์ œ ๊ณผ์ •์—์„œ ์–ธ์ œ๋“ ์ง€ ๊ฒฐ์ œ๋ฅผ ๋ณ€๊ฒฝํ•˜๊ฑฐ๋‚˜ ์ทจ์†Œํ•  ์ˆ˜ ์žˆ๋Š” ์œ ์—ฐ์„ฑ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ์‹ค์ œ ๊ธˆ์•ก ์ฒญ๊ตฌ๊ฐ€ ์ด๋ฃจ์–ด์ง€์ง€ ์•Š์•˜์œผ๋ฏ€๋กœ, ๊ฑฐ๋ž˜ ๋ณ€๊ฒฝ์ด๋‚˜ ์ทจ์†Œ๊ฐ€ ๋” ์‰ฝ๊ณ  ๋น ๋ฆ…๋‹ˆ๋‹ค. ex) ์ •๊ธฐ๊ฒฐ์ œ

๊ฐ€๋งน์  ์ž…์žฅ์—์„œ ์‹ค์ œ ๊ฒฐ์ œ๋ฅผ ์ง„ํ–‰ํ•˜๊ธฐ ์ „์— ์นด๋“œ์˜ ์œ ํšจ์„ฑ์„ ๋ฏธ๋ฆฌ ํ™•์ธํ•  ์ˆ˜ ์žˆ์–ด, ๋ถˆํ•„์š”ํ•œ ์Šน์ธ ์š”์ฒญ์„ ์ค„์ผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋˜, ์ธ์ฆ ๋‹จ๊ณ„์—์„œ์˜ ๋ฌธ์ œ์™€ ์Šน์ธ ๋‹จ๊ณ„์—์„œ์˜ ๋ฌธ์ œ๋ฅผ ๋”ฐ๋กœ ๋‹ค๋ฃจ์–ด, ๋ฌธ์ œ ํ•ด๊ฒฐ์ด ๋” ์‰ฝ๊ณ  ๋ช…ํ™•ํ•˜๊ฒŒ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๊ฑฐ๋ž˜์˜ ์ •ํ™•์„ฑ ํ™•์ธ

์ธ์ฆ ๋‹จ๊ณ„์—์„œ ๊ฒฐ์ œ ์ˆ˜๋‹จ์˜ ์œ ํšจ์„ฑ์„ ํ™•์ธํ•˜๊ณ , ์Šน์ธ ๋‹จ๊ณ„์—์„œ ์‹ค์ œ ๊ธˆ์•ก์„ ์ฒญ๊ตฌํ•˜๊ธฐ ์ „์— ๊ฑฐ๋ž˜ ๋‚ด์šฉ์„ ์žฌํ™•์ธํ•จ์œผ๋กœ์จ, ์ž˜๋ชป๋œ ๊ธˆ์•ก ๋˜๋Š” ๊ฒฐ์ œ ์ •๋ณด์˜ ์ฒ˜๋ฆฌ๋ฅผ ๋ฐฉ์ง€ํ•ฉ๋‹ˆ๋‹ค. ์ด๋ฅผ ํ†ตํ•ด ๊ฑฐ๋ž˜์˜ ์ •ํ™•์„ฑ๊ณผ ์‹ ๋ขฐ์„ฑ์„ ๋ณด์žฅํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

ex) ๊ฐ ์‘๋‹ต ๋ช…์„ธ์˜ signature ํ•„๋“œ ๊ฒ€์ฆ

์ธ์ฆ & ์Šน์ธ ํ•œ๋ฒˆ์— ์ฒ˜๋ฆฌํ•  ์ˆœ ์—†์„๊นŒ?

'1transaction' ์„œ๋น„์Šค๋Š” ๊ฒฐ์ œ ๊ณผ์ •์—์„œ ์ธ์ฆ๊ณผ ์Šน์ธ์„ ํ•˜๋‚˜์˜ ๊ฑฐ๋ž˜๋กœ ์ฒ˜๋ฆฌํ•˜๋Š” ๋ฐฉ์‹์ž…๋‹ˆ๋‹ค. ๊ณ ๊ฐ์ด ๊ฒฐ์ œ๋ฅผ ์š”์ฒญํ•˜๋ฉด, ๊ฐ€๋งน์ ์€ ๋‚˜์ด์ŠคํŽ˜์ด๋จผ์ธ  ์ธก์œผ๋กœ ๊ฒฐ์ œ์ฐฝ์„ ํ˜ธ์ถœ๋งŒ ํ•˜๋ฉด ๋ฉ๋‹ˆ๋‹ค. ๋‚˜์ด์ŠคํŽ˜์ด๋จผ์ธ ๋Š” ์ธ์ฆ๊ณผ ์Šน์ธ ์ฒ˜๋ฆฌ๋ฅผ ๋ชจ๋‘ ํ•œ ๋ฒˆ์— ์ฒ˜๋ฆฌํ•œ ํ›„, ๊ทธ ๊ฒฐ๊ณผ๋ฅผ ๊ฐ€๋งน์ ์—๊ฒŒ ๋ฐ˜ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

์ด ์„œ๋น„์Šค์˜ ๊ฐ€์žฅ ํฐ ์žฅ์ ์€ ์—ฐ๋™์˜ ๊ฐ„ํŽธํ•จ์ž…๋‹ˆ๋‹ค. ๊ฐ€๋งน์ ์€ ๋ณต์žกํ•œ ์ธ์ฆ๊ณผ ์Šน์ธ ๊ณผ์ •์„ ๋”ฐ๋กœ ์ฒ˜๋ฆฌํ•  ํ•„์š” ์—†์ด, ๋‹จ์ผ ์š”์ฒญ์œผ๋กœ ๊ฒฐ์ œ๋ฅผ ์™„๋ฃŒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์ฃผ์˜ํ•ด์•ผ ํ•  ์‚ฌํ•ญ

ํ•˜์ง€๋งŒ ์ด๋Ÿฐ ๊ฐ„ํŽธํ•จ์€ ์ผ๋ถ€ ์ฃผ์˜ํ•ด์•ผ ํ•  ์ ๋“ค์„ ์ˆ˜๋ฐ˜ํ•ฉ๋‹ˆ๋‹ค.

  1. ์„œ๋ฒ„๊ฐ„ ํ†ต์‹ ์˜ ์•ˆ์ „์„ฑ

๋‚˜์ด์ŠคํŽ˜์ด๋จผ์ธ  forStartup์—์„œ ์ธ์ฆ & ์Šน์ธ์„ ํ•˜๋‚˜์˜ ๊ฑฐ๋ž˜๋กœ ์ฒ˜๋ฆฌํ•˜์—ฌ ํ•ด๋‹น ๊ฒฐ๊ณผ๋ฅผ ๋ฐ˜ํ™˜ํ•˜๊ธฐ ๋•Œ๋ฌธ์— ๊ฐ€๋งน์ ์˜ ๋„คํŠธ์›Œํฌ ํ™˜๊ฒฝ์œผ๋กœ ์ธํ•˜์—ฌ Read Timeout์ด ๋ฐœ์ƒํ•˜๋Š” ๊ฒฝ์šฐ, ์–ด๋– ํ•œ ์‚ฌ์œ ์—์„œ ์‘๋‹ต์„ ๋ฐ›์ง€ ๋ชปํ–ˆ๋Š”์ง€ ์•Œ ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค.

์ด๋ฅผ ์œ„ํ•ด ์‹ค์‹œ๊ฐ„ ์›นํ›… ์„œ๋น„์Šค๋ฅผ ํ•จ๊ป˜ ์ œ๊ณตํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค. ํ•ด๋‹น ๊ฒฐ์ œ์ˆ˜๋‹จ์˜ ์›นํ›… URL์„ ๋“ฑ๋กํ•˜์—ฌ ๊ฒฐ์ œ๊ฒฐ๊ณผ๋ฅผ ์‘๋‹ต๋ฐ›์•„ ์ง„ํ–‰ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๋งŒ์•ฝ, ๊ฐ€๋งน์ ์€ 1transaction ์„œ๋น„์Šค์— ๋Œ€ํ•œ ์‘๋‹ต์„ ๋ฐ›์ง€ ๋ชปํ•˜๋Š” ๊ฒฝ์šฐ, ๋ง์ทจ์†Œ์™€ ๊ฐ™์€ ๊ธฐ๋Šฅ์„ ํ†ตํ•ด ๊ฑฐ๋ž˜์— ๋Œ€ํ•œ ์ผ๊ด€์„ฑ์„ ๋ณด์žฅํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

  1. ์œ ์—ฐ์„ฑ์˜ ์ œํ•œ

์ธ์ฆ๊ณผ ์Šน์ธ์„ ๋ณ„๋„๋กœ ์ฒ˜๋ฆฌํ•˜๋Š” ๊ธฐ์กด ๋ฐฉ์‹์€ ๊ฑฐ๋ž˜์˜ ์œ ์—ฐ์„ฑ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ๋ฐ˜๋ฉด, ๋‘ ๊ณผ์ •์ด ํ•˜๋‚˜๋กœ ํ•ฉ์ณ์„œ ์ฒ˜๋ฆฌํ•˜๋ฏ€๋กœ, ๊ฐ€๋งน์  ์ž…์žฅ์—์„œ ๊ตฌ๊ฐ„๋ณ„๋กœ ๋ณ„๋„์˜ ์ฒ˜๋ฆฌ๋‚˜ ๊ฒ€์ฆ ๋‹จ๊ณ„๋ฅผ ๊ตฌํ˜„ํ•˜๋ ค๊ณ  ํ•˜๋Š” ๋ถ€๋ถ„์ด ์ œํ•œ๋  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด๋Š” ํŠน์ˆ˜ํ•œ ์ƒํ™ฉ์—์„œ ์—๋Ÿฌ ๋Œ€์‘์ด ๋” ๊นŒ๋‹ค๋กœ์šธ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๊ฒฐ๊ตญ, 1transaction ์„œ๋น„์Šค๋Š” ์—ฐ๋™์˜ ๊ฐ„ํŽธํ•จ์„ ์ œ๊ณตํ•˜์ง€๋งŒ, ์„œ๋ฒ„ ๊ฐ„์˜ ๋„คํŠธ์›Œํฌ ํ†ต์‹ ์˜ ์•ˆ์ •์„ฑ, ์œ ์—ฐ์„ฑ ๋“ฑ์„ ์ถฉ๋ถ„ํžˆ ๊ณ ๋ คํ•ด์•ผ ํ•˜๋Š” ํŠธ๋ ˆ์ด๋“œ ์˜คํ”„๊ฐ€ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ฐ€๋งน์ ์€ ์ด๋Ÿฌํ•œ ์š”์†Œ๋ฅผ ์ถฉ๋ถ„ํžˆ ๊ฒ€ํ† ํ•˜๊ณ , ์ž์‹ ์˜ ๋น„์ฆˆ๋‹ˆ์Šค ์š”๊ตฌ์‚ฌํ•ญ๊ณผ ๋งž๋Š”์ง€ ํŒ๋‹จ ํ›„ ํ•ด๋‹น ์„œ๋น„์Šค๋ฅผ ์‚ฌ์šฉํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.