Skip to content

bootpay/backend-python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

66 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Bootpay Python Server Side Library

๋ถ€ํŠธํŽ˜์ด ๊ณต์‹ ํŒŒ์ด์ฌ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์ž…๋‹ˆ๋‹ค (์„œ๋ฒ„์‚ฌ์ด๋“œ ์šฉ)

Python ์–ธ์–ด๋กœ ์ž‘์„ฑ๋œ ์–ดํ”Œ๋ฆฌ์ผ€์ด์…˜, ํ”„๋ ˆ์ž„์›Œํฌ ๋“ฑ์—์„œ ์‚ฌ์šฉ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

  • PG ๊ฒฐ์ œ์ฐฝ ์—ฐ๋™์€ ํด๋ผ์ด์–ธํŠธ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์—์„œ ์ˆ˜ํ–‰๋ฉ๋‹ˆ๋‹ค. (Javascript, Android, iOS, React Native, Flutter ๋“ฑ)
  • ๊ฒฐ์ œ ๊ฒ€์ฆ ๋ฐ ์ทจ์†Œ, ๋นŒ๋งํ‚ค ๋ฐœ๊ธ‰, ๋ณธ์ธ์ธ์ฆ ๋“ฑ์˜ ์ˆ˜ํ–‰์€ ์„œ๋ฒ„์‚ฌ์ด๋“œ์—์„œ ์ง„ํ–‰๋ฉ๋‹ˆ๋‹ค. (Java, PHP, Python, Ruby, Node.js, Go, ASP.NET ๋“ฑ)

๋ชฉ์ฐจ

pypi๋กœ ์„ค์น˜ํ•˜๊ธฐ

pip install bootpay-backend

์‚ฌ์šฉํ•˜๊ธฐ

from bootpay_backend import BootpayBackend

bootpay = BootpayBackend('5b8f6a4d396fa665fdc2b5ea', 'rm6EYECr6aroQVG2ntW0A6LpWnkTgP4uQ3H18sDDUYw=')

token = bootpay.get_access_token() 
if 'error_code' not in token:
    # ํ† ํฐ ๋ฐœ๊ธ‰ ์„ฑ๊ณต 
    print(token)

1. ํ† ํฐ ๋ฐœ๊ธ‰

๋ถ€ํŠธํŽ˜์ด์™€ ์„œ๋ฒ„๊ฐ„ ํ†ต์‹ ์„ ํ•˜๊ธฐ ์œ„ํ•ด์„œ๋Š” ๋ถ€ํŠธํŽ˜์ด ์„œ๋ฒ„๋กœ๋ถ€ํ„ฐ ํ† ํฐ์„ ๋ฐœ๊ธ‰๋ฐ›์•„์•ผ ํ•ฉ๋‹ˆ๋‹ค.
๋ฐœ๊ธ‰๋œ ํ† ํฐ์€ 30๋ถ„๊ฐ„ ์œ ํšจํ•˜๋ฉฐ, ์ตœ์ดˆ ๋ฐœ๊ธ‰์ผ๋กœ๋ถ€ํ„ฐ 30๋ถ„์ด ์ง€๋‚  ๊ฒฝ์šฐ ํ† ํฐ ๋ฐœ๊ธ‰ ํ•จ์ˆ˜๋ฅผ ์žฌํ˜ธ์ถœ ํ•ด์ฃผ์…”์•ผ ํ•ฉ๋‹ˆ๋‹ค.

bootpay = BootpayBackend('5b8f6a4d396fa665fdc2b5ea', 'rm6EYECr6aroQVG2ntW0A6LpWnkTgP4uQ3H18sDDUYw=')

token = bootpay.get_access_token() 
if 'error_code' not in token:
    # ํ† ํฐ ๋ฐœ๊ธ‰ ์„ฑ๊ณต 
    print(token)

2. ๊ฒฐ์ œ ๋‹จ๊ฑด ์กฐํšŒ

๊ฒฐ์ œ์ฐฝ ๋ฐ ์ •๊ธฐ๊ฒฐ์ œ์—์„œ ์Šน์ธ/์ทจ์†Œ๋œ ๊ฒฐ์ œ๊ฑด์— ๋Œ€ํ•˜์—ฌ ์˜ฌ๋ฐ”๋ฅธ ๊ฒฐ์ œ๊ฑด์ธ์ง€ ์„œ๋ฒ„๊ฐ„ ํ†ต์‹ ์œผ๋กœ ๊ฒฐ์ œ๊ฒ€์ฆ์„ ํ•ฉ๋‹ˆ๋‹ค.

response = bootpay.receipt_payment('62b2c3c2d01c7e001bc20b10')
if 'error_code' not in response:
    # ์š”์ฒญ ์„ฑ๊ณต 
    print(response)

3. ๊ฒฐ์ œ ์ทจ์†Œ (์ „์•ก ์ทจ์†Œ / ๋ถ€๋ถ„ ์ทจ์†Œ)

price๋ฅผ ์ง€์ •ํ•˜์ง€ ์•Š์œผ๋ฉด ์ „์•ก์ทจ์†Œ ๋ฉ๋‹ˆ๋‹ค.

  • ํœด๋Œ€ํฐ ๊ฒฐ์ œ์˜ ๊ฒฝ์šฐ ์ด์›”๋  ๊ฒฝ์šฐ ์ดํ†ต์‚ฌ ์ •์ฑ…์ƒ ์ทจ์†Œ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค
  • ์ •์‚ฐ๋ฐ›์œผ์‹ค ๊ธˆ์•ก๋ณด๋‹ค ์ทจ์†Œ๊ธˆ์•ก์ด ํด ๊ฒฝ์šฐ PG์‚ฌ ์ •์ฑ…์ƒ ์ทจ์†Œ๋˜์ง€ ์•Š์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด๋•Œ PG์‚ฌ์— ๋ฌธ์˜ํ•˜์‹œ๋ฉด ๋˜๊ฒ ์Šต๋‹ˆ๋‹ค.
  • ๊ฐ€์ƒ๊ณ„์ขŒ์˜ ๊ฒฝ์šฐ CMS ํŠน์•ฝ์ด ๋˜์–ด์žˆ์ง€ ์•Š์œผ๋ฉด ์ทจ์†Œ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๊ทธ๋Ÿฌ๋ฏ€๋กœ ๊ฒฐ์ œ ํ…Œ์ŠคํŠธ์‹œ์—๋Š” ๊ฐ€์ƒ๊ณ„์ขŒ๋กœ ํ…Œ์ŠคํŠธ ํ•˜์ง€ ์•Š๊ธธ ์ถ”์ฒœํ•ฉ๋‹ˆ๋‹ค.

๋ถ€๋ถ„์ทจ๋Š” ์นด๋“œ๋กœ ๊ฒฐ์ œ๋œ ๊ฑด๋งŒ ๊ฐ€๋Šฅํ•˜๋ฉฐ, ์ผ๋ถ€ PG์‚ฌ๋งŒ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค. ์š”์ฒญ์‹œ price์— ๊ธˆ์•ก์„ ์ง€์ •ํ•˜์‹œ๋ฉด ๋˜๊ฒ ์Šต๋‹ˆ๋‹ค.

  • (์ง€์›๊ฐ€๋Šฅ PG์‚ฌ: ์ด๋‹ˆ์‹œ์Šค, kcp, ๋‹ค๋‚ , ํŽ˜์ด๋ ˆํ„ฐ, ๋‚˜์ด์ŠคํŽ˜์ด, ์นด์นด์˜คํŽ˜์ด, ํŽ˜์ด์ฝ”)

๊ฐ„ํ˜น ๊ฐœ๋ฐœ์‚ฌ์—์„œ ์‹ค์ˆ˜๋กœ ์—ฌ๋Ÿฌ๋ฒˆ ๋ถ€๋ถ„์ทจ์†Œ๋ฅผ ๋ณด๋‚ด์„œ ์—ฌ๋Ÿฌ๋ฒˆ ์ทจ์†Œ๋˜๋Š” ๊ฒฝ์šฐ๊ฐ€ ์žˆ๊ธฐ๋•Œ๋ฌธ์—, ๋ถ€ํŠธํŽ˜์ด์—์„œ๋Š” ๋ถ€๋ถ„์ทจ์†Œ ์ค‘๋ณต ์š”์ฒญ์„ ๋ง‰๊ธฐ ์œ„ํ•ด cancel_id ๋ผ๋Š” ํ•„๋“œ๋ฅผ ์ถ”๊ฐ€ํ–ˆ์Šต๋‹ˆ๋‹ค. cancel_id๋ฅผ ์ง€์ •ํ•˜์‹œ๋ฉด, ํ•ด๋‹น ๊ฑด์— ๋Œ€ํ•ด ์ค‘๋ณต ์š”์ฒญ๋ฐฉ์ง€๊ฐ€ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

response = bootpay.cancel_payment(
        receipt_id='62ba5a3cd01c7e001fb45c46', 
        cancel_id=str(uuid.uuid4()),
        cancel_username='test', 
        cancel_message='test๊ฒฐ์ œ ์ทจ์†Œ'
    )
if 'error_code' not in response:
    # ์š”์ฒญ ์„ฑ๊ณต 
    print(response)

4. ์ž๋™/๋นŒ๋ง/์ •๊ธฐ ๊ฒฐ์ œ

4-1. ์นด๋“œ ๋นŒ๋งํ‚ค ๋ฐœ๊ธ‰

REST API ๋ฐฉ์‹์œผ๋กœ ๊ณ ๊ฐ์œผ๋กœ๋ถ€ํ„ฐ ์นด๋“œ ์ •๋ณด๋ฅผ ์ „๋‹ฌํ•˜์—ฌ, PG์‚ฌ์—๊ฒŒ ๋นŒ๋งํ‚ค๋ฅผ ๋ฐœ๊ธ‰๋ฐ›์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋ฐœ๊ธ‰๋ฐ›์€ ๋นŒ๋งํ‚ค๋ฅผ ์ €์žฅํ•˜๊ณ  ์žˆ๋‹ค๊ฐ€, ์›ํ•˜๋Š” ์‹œ์ , ์›ํ•˜๋Š” ๊ธˆ์•ก์— ๊ฒฐ์ œ ์Šน์ธ ์š”์ฒญํ•˜์—ฌ ์ข€ ๋” ์ž์œ ๋กœ์šด ๊ฒฐ์ œ์‹œ๋‚˜๋ฆฌ์˜ค์— ์ ์šฉ์ด ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

  • ๋น„์ธ์ฆ ์ •๊ธฐ๊ฒฐ์ œ(REST API) ๋ฐฉ์‹์„ ์ง€์›ํ•˜๋Š” PG์‚ฌ๋งŒ ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.
response = bootpay.request_subscribe_billing_key(
        pg='๋‚˜์ด์ŠคํŽ˜์ด',
        order_name='ํ…Œ์ŠคํŠธ๊ฒฐ์ œ',
        subscription_id=str(time.time()),
        card_no="5570********1074", # ์นด๋“œ๋ฒˆํ˜ธ 
        card_pw="**", # ์นด๋“œ ๋น„๋ฐ€๋ฒˆํ˜ธ 2์ž๋ฆฌ 
        card_identity_no="******", # ์นด๋“œ ์†Œ์ฃผ ์ƒ๋…„์›”์ผ 
        card_expire_year="**", # ์นด๋“œ ์œ ํšจ๊ธฐ๊ฐ„ ๋…„ 2์ž๋ฆฌ 
        card_expire_month="**",  # ์นด๋“œ ์œ ํšจ๊ธฐ๊ฐ„ ์›” 2์ž๋ฆฌ 

    )
if 'error_code' not in response:
    # ์š”์ฒญ ์„ฑ๊ณต 
    print(response)

4-2. ๊ณ„์ขŒ ๋นŒ๋งํ‚ค ๋ฐœ๊ธ‰

REST API ๋ฐฉ์‹์œผ๋กœ ๊ณ ๊ฐ์˜ ๊ณ„์ขŒ ์ •๋ณด๋ฅผ ์ „๋‹ฌํ•˜์—ฌ, PG์‚ฌ์—๊ฒŒ ๋นŒ๋งํ‚ค ๋ฐœ๊ธ‰์„ ์š”์ฒญํ•ฉ๋‹ˆ๋‹ค. ์š”์ฒญ ํ›„ ๋นŒ๋งํ‚ค๊ฐ€ ๋ฐ”๋กœ ๋ฐœ๊ธ‰๋˜์ง„ ์•Š๊ณ , ์ถœ๊ธˆ๋™์˜ ํ™•์ธ ์ ˆ์ฐจ๊นŒ์ง€ ์ง„ํ–‰ํ•ด์•ผ ๋นŒ๋งํ‚ค๊ฐ€ ๋ฐœ๊ธ‰๋ฉ๋‹ˆ๋‹ค. ๋จผ์ € ๋นŒ๋งํ‚ค๋ฅผ ์š”์ฒญํ•ฉ๋‹ˆ๋‹ค.

response = bootpay.request_subscribe_automatic_transfer_billing_key(
        pg="๋‚˜์ด์ŠคํŽ˜์ด",
        order_name='ํ…Œ์ŠคํŠธ๊ฒฐ์ œ',
        subscription_id=str(time.time()),
        price=1000,
        username='ํ™๊ธธ๋™',
        bank_name='๊ตญ๋ฏผ',
        bank_account='67560123412342472',
        identity_no='901014',
        cash_receipt_identity_no='01012341234',
        phone='01012341234'
    )

์ดํ›„ ๋นŒ๋งํ‚ค ๋ฐœ๊ธ‰ ์š”์ฒญ์‹œ ์‘๋‹ต๋ฐ›์€ receipt_id๋กœ, ์ถœ๊ธˆ ๋™์˜ ํ™•์ธ์„ ์š”์ฒญํ•ฉ๋‹ˆ๋‹ค.

response = bootpay.publish_automatic_transfer_billing_key(
    receipt_id="66542d4be86c1eedf6b17965",
)

4-3. ๊ฒฐ์ œ ์š”์ฒญํ•˜๊ธฐ

๋ฐœ๊ธ‰๋œ ๋นŒ๋งํ‚ค๋กœ ์›ํ•˜๋Š” ์‹œ์ ์— ์›ํ•˜๋Š” ๊ธˆ์•ก์œผ๋กœ ๊ฒฐ์ œ ์Šน์ธ ์š”์ฒญ์„ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ž”์•ก์ด ๋ถ€์กฑํ•˜๊ฑฐ๋‚˜ ๋„๋‚œ ์นด๋“œ ๋“ฑ์˜ ํŠน๋ณ„ํ•œ ๊ฑด์ด ์•„๋‹ˆ๋ฉด PG์‚ฌ์—์„œ ๊ฒฐ์ œ๋ฅผ ๋ฐ”๋กœ ์Šน์ธํ•ฉ๋‹ˆ๋‹ค.

response = bootpay.request_subscribe_card_payment(
        billing_key='62b2c3cfd01c7e001cc20a84',
        order_name='ํ…Œ์ŠคํŠธ๊ฒฐ์ œ',
        order_id=str(time.time()),
        price=100,
        user={
            "phone": '01000000000',
            "username": 'ํ™๊ธธ๋™',
            "email": 'test@bootpay.co.kr'
        }
    )
if 'error_code' not in response:
    # ์š”์ฒญ ์„ฑ๊ณต 
    print(response)

4-4. ๊ฒฐ์ œ ์˜ˆ์•ฝํ•˜๊ธฐ

์›ํ•˜๋Š” ์‹œ์ ์— 4-1๋กœ ๊ฒฐ์ œ ์Šน์ธ ์š”์ฒญ์„ ๋ณด๋‚ด๋„ ๋˜์ง€๋งŒ, ๋นŒ๋งํ‚ค ๋ฐœ๊ธ‰ ์ดํ›„์— ๋ฐ”๋กœ ๊ฒฐ์ œ ์˜ˆ์•ฝ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. (๋นŒ๋งํ‚ค๋‹น ์ตœ๋Œ€ 10๊ฑด)

response = bootpay.subscribe_payment_reserve(
        billing_key='[ ๋นŒ๋งํ‚ค ]',
        order_name='ํ…Œ์ŠคํŠธ๊ฒฐ์ œ',
        order_id=str(time.time()),
        price=1000,
        user={
            "phone": '01000000000',
            "username": 'ํ™๊ธธ๋™',
            "email": 'test@bootpay.co.kr'
        },
        reserve_execute_at=(datetime.datetime.now() + datetime.timedelta(seconds=5)).astimezone().strftime(
            '%Y-%m-%dT%H:%M:%S%z')
    )
if 'error_code' not in response:
    # ์š”์ฒญ ์„ฑ๊ณต 
    print(response)

4-5. ์˜ˆ์•ฝ ์กฐํšŒํ•˜๊ธฐ

์˜ˆ์•ฝ์‹œ ์‘๋‹ต๋ฐ›์€ reserveId๋กœ ์˜ˆ์•ฝ๋œ ๊ฑด์„ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.

response = bootpay.subscribe_payment_reserve_lookup('6490149ca575b40024f0b70d')
print(response)

4-6. ์˜ˆ์•ฝ ์ทจ์†Œํ•˜๊ธฐ

์˜ˆ์•ฝ์‹œ ์‘๋‹ต๋ฐ›์€ reserveId๋กœ ์˜ˆ์•ฝ๋œ ๊ฑด์„ ์ทจ์†Œํ•ฉ๋‹ˆ๋‹ค.

result = bootpay.cancel_subscribe_reserve(
        '612debc70d681b0039e6133d'
    )
if 'error_code' not in response:
    # ์š”์ฒญ ์„ฑ๊ณต 
    print(response)

4-7. ๋นŒ๋งํ‚ค ์‚ญ์ œํ•˜๊ธฐ

๋ฐœ๊ธ‰๋œ ๋นŒ๋งํ‚ค๋ฅผ ์‚ญ์ œํ•ฉ๋‹ˆ๋‹ค. ์‚ญ์ œํ•˜๋”๋ผ๋„ ์˜ˆ์•ฝ๋œ ๊ฒฐ์ œ๊ฑด์€ ์ทจ์†Œ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์˜ˆ์•ฝ๋œ ๊ฒฐ์ œ๊ฑด ์ทจ์†Œ๋ฅผ ์›ํ•˜์‹œ๋ฉด ์˜ˆ์•ฝ ์ทจ์†Œํ•˜๊ธฐ๋ฅผ ์š”์ฒญํ•˜์…”์•ผ ํ•ฉ๋‹ˆ๋‹ค.

response = bootpay.destroy_billing_key(
        billing_key='62b2c3cfd01c7e001cc20a85',
)
if 'error_code' not in response:
    # ์š”์ฒญ ์„ฑ๊ณต 
    print(response)

4-8. ๋นŒ๋งํ‚ค ์กฐํšŒํ•˜๊ธฐ

ํด๋ผ์ด์–ธํŠธ์—์„œ ๋นŒ๋งํ‚ค ๋ฐœ๊ธ‰์‹œ, ๋ณด์•ˆ์ƒ ํด๋ผ์ด์–ธํŠธ ์ด๋ฒคํŠธ์— ๋นŒ๋งํ‚ค๋ฅผ ์ „๋‹ฌํ•ด์ฃผ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๊ทธ๋Ÿฌ๋ฏ€๋กœ ์ด API๋ฅผ ํ†ตํ•ด ์กฐํšŒํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ๋‹ค์Œ์€ ๋นŒ๋งํ‚ค ๋ฐœ๊ธ‰ ์š”์ฒญํ–ˆ๋˜ receiptId ๋กœ ๋นŒ๋งํ‚ค๋ฅผ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.

response = bootpay.lookup_subscribe_billing_key('62b2c3c2d01c7e001bc20b10')
if 'error_code' not in response:
    # ์š”์ฒญ ์„ฑ๊ณต 
    print(response)

์•„๋ž˜๋Š” billingKey๋กœ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.

response = bootpay.lookup_billing_key('66542dfb4d18d5fc7b43e1b6')
print(response)

5. ํšŒ์› ํ† ํฐ ๋ฐœ๊ธ‰์š”์ฒญ

ใ…‡ใ…‡ํŽ˜์ด ์‚ฌ์šฉ์„ ์œ„ํ•ด ๊ฐ€๋งน์  ํšŒ์›์˜ ํ† ํฐ์„ ๋ฐœ๊ธ‰ํ•ฉ๋‹ˆ๋‹ค. ๊ฐ€๋งน์ ์€ ํšŒ์›์˜ ๊ณ ์œ ๋ฒˆํ˜ธ๋ฅผ ๊ด€๋ฆฌํ•ด์•ผํ•ฉ๋‹ˆ๋‹ค. ์ด ํ† ํฐ๊ฐ’์„ ๊ธฐ๋ฐ˜์œผ๋กœ ํด๋ผ์ด์–ธํŠธ์—์„œ ๊ฒฐ์ œ์š”์ฒญ(payload.user_token) ํ•˜์‹œ๋ฉด ๋˜๊ฒ ์Šต๋‹ˆ๋‹ค.

result = bootpay.request_user_token({
        'user_id': '12341-234',
        'email': 'test@email.com',
        'name': 'ํ™๊ธธ๋™',
        'gender': '1',
        'birth': '901014',
        'phone': '01012341234'
    })
if 'error_code' not in token: 
    # ์š”์ฒญ ์„ฑ๊ณต 
    print(response)

6. ์„œ๋ฒ„ ์Šน์ธ ์š”์ฒญ

๊ฒฐ์ œ์Šน์ธ ๋ฐฉ์‹์€ ํด๋ผ์ด์–ธํŠธ ์Šน์ธ ๋ฐฉ์‹๊ณผ, ์„œ๋ฒ„ ์Šน์ธ ๋ฐฉ์‹์œผ๋กœ ์ด 2๊ฐ€์ง€๊ฐ€ ์žˆ์Šต๋‹ˆ๋‹ค.

ํด๋ผ์ด์–ธํŠธ ์Šน์ธ ๋ฐฉ์‹์€ pythonscript๋‚˜ native ๋“ฑ์—์„œ confirm ํ•จ์ˆ˜์—์„œ ์ง„ํ–‰ํ•˜๋Š” ์ผ๋ฐ˜์ ์ธ ๋ฐฉ๋ฒ•์ž…๋‹ˆ๋‹ค๋งŒ, ๊ฒฝ์šฐ์— ๋”ฐ๋ผ ์„œ๋ฒ„ ์Šน์ธ ๋ฐฉ์‹์ด ํ•„์š”ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

ํ•„์š”ํ•œ ์ด์œ 

  1. 100% ์•ˆ์ •์ ์ธ ๊ฒฐ์ œ ํ›„ ๊ณ ๊ฐ ์•ˆ๋‚ด๋ฅผ ์œ„ํ•ด - ํด๋ผ์ด์–ธํŠธ์—์„œ PG๊ฒฐ์ œ ์ง„ํ–‰ ํ›„ ์Šน์ธ ์™„๋ฃŒ๋  ๋•Œ onDone์ด ์ˆ˜ํ–‰๋˜์ง€ ์•Š์•„ (์ธํ„ฐ๋„ท ํ™˜๊ฒฝ ๋“ฑ), ๊ฒฐ์ œ ์ดํ›„ ๊ณ ๊ฐ์—๊ฒŒ ์•ˆ๋‚ดํ•˜์ง€ ๋ชปํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค
  2. ๋‹จ์ผ ํŠธ๋žœ์žญ์…˜์˜ ๊ฐœ๋…์ด ํ•„์š”ํ•  ๊ฒฝ์šฐ - ์žฌ๊ณ ํŒŒ์•…์ด ์ค‘์š”ํ•œ ์ปค๋จธ์Šค๋ฅผ ์šด์˜ํ•  ๊ฒฝ์šฐ ํŠธ๋žœ์žญ์…˜ ๊ฐœ๋…์ด ํ•„์š”ํ•  ์ˆ˜ ์žˆ๊ฒ ์œผ๋ฉฐ, ์ด๋ฅผ ์œ„ํ•ด์„œ๋Š” ์„œ๋ฒ„ ์Šน์ธ์„ ์‚ฌ์šฉํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.
result = bootpay.confirm_payment(
    receipt_id='612df0250d681b001de61de6'
)
if 'error_code' not in token: 
    # ์š”์ฒญ ์„ฑ๊ณต 
    print(response)

7. ๋ณธ์ธ ์ธ์ฆ ๊ฒฐ๊ณผ ์กฐํšŒ

๋‹ค๋‚  ๋ณธ์ธ์ธ์ฆ ํ›„ ๊ฒฐ๊ณผ๊ฐ’์„ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค. ๋‹ค๋‚  ๋ณธ์ธ์ธ์ฆ์—์„œ ํ†ต์‹ ์‚ฌ, ์™ธ๊ตญ์ธ์—ฌ๋ถ€, ์ „ํ™”๋ฒˆํ˜ธ ์ด 3๊ฐ€์ง€ ์ •๋ณด๋Š” ๋‹ค๋‚ ์— ์ถ”๊ฐ€๋กœ ์š”์ฒญํ•˜์…”์•ผ ๋ฐ›์œผ์‹ค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

result = bootpay.certificate(
        receipt_id='612df0250d681b001de61de6'
)
if 'error_code' not in token: 
    # ์š”์ฒญ ์„ฑ๊ณต 
    print(response)
  1. (์—์Šคํฌ๋กœ ์ด์šฉ์‹œ) PG์‚ฌ๋กœ ๋ฐฐ์†ก์ •๋ณด ๋ณด๋‚ด๊ธฐ ํ˜„๊ธˆ ๊ฑฐ๋ž˜์— ํ•œํ•ด ๊ตฌ๋งค์ž์˜ ์•ˆ์ „๊ฑฐ๋ž˜๋ฅผ ๋ณด์žฅํ•˜๋Š” ๋ฐฉ๋ฒ•์œผ๋กœ, ํŒ๋งค์ž์™€ ๊ตฌ๋งค์ž์˜ ์˜จ๋ผ์ธ ์ „์ž์ƒ๊ฑฐ๋ž˜๊ฐ€ ์›ํ™œํ•˜๊ฒŒ ์ด๋ฃจ์–ด์งˆ ์ˆ˜ ์žˆ๋„๋ก ์ค‘๊ณ„ํ•ด์ฃผ๋Š” ๋งค๋งค๋ณดํ˜ธ์„œ๋น„์Šค์ž…๋‹ˆ๋‹ค. ๊ตญ๋‚ด๋ฒ•์— ๋”ฐ๋ผ ์ „์ž์ƒ๊ฑฐ๋ž˜์—์„œ ๋ฐ˜๋“œ์‹œ ์ ์šฉ์ด ๋˜์–ด ์žˆ์–ด์•ผํ•ฉ๋‹ˆ๋‹ค. PG์—์„œ๋„ ์—์Šคํฌ๋กœ ๊ฒฐ์ œ๋ฅผ ์ง€์›ํ•˜๋ฉฐ, ์—์Šคํฌ๋กœ ๊ฒฐ์ œ ์‚ฌ์šฉ์„ ์›ํ•˜์‹œ๋ฉด PG์‚ฌ ๊ฐ€๋งน์‹œ์— ์—์Šคํฌ๋กœ๊ฒฐ์ œ๋ฅผ ๋ฏธ๋ฆฌ ์–˜๊ธฐํ•˜๊ณ ๋‚˜์„œ ์ง„ํ–‰์„ ํ•˜์‹œ๋Š” ๊ฒƒ์ด ์ˆ˜์›”ํ•ฉ๋‹ˆ๋‹ค.

PG์‚ฌ๋กœ ๋ฐฐ์†ก์ •๋ณด( ์ด๋‹ˆ์‹œ์Šค, KCP๋งŒ ์ง€์› )๋ฅผ ๋ณด๋‚ด์„œ ์—์Šคํฌ๋กœ ์ƒํƒœ๋ฅผ ๋ณ€๊ฒฝํ•˜๋Š” API ์ž…๋‹ˆ๋‹ค.

response = bootpay.shipping_start(
        receipt_id="62a946aad01c7e001b7dc20b",
        tracking_number='3989838',
        delivery_corp='CJ๋Œ€ํ•œํ†ต์šด',
        user={
            "phone": '01000000000',
            "username": 'ํ™๊ธธ๋™',
            "address": "์„œ์šธํŠน๋ณ„์‹œ ์ข…๋กœ๊ตฌ",
            "zipcode": "039899"
        }
)
if 'error_code' not in token: 
    # ์š”์ฒญ ์„ฑ๊ณต 
    print(response)

9-1. ํ˜„๊ธˆ์˜์ˆ˜์ฆ ๋ฐœํ–‰ํ•˜๊ธฐ

bootpay api๋ฅผ ํ†ตํ•ด ๊ฒฐ์ œ๋œ ๊ฑด์— ๋Œ€ํ•˜์—ฌ ํ˜„๊ธˆ์˜์ˆ˜์ฆ์„ ๋ฐœํ–‰ํ•ฉ๋‹ˆ๋‹ค.

response = bootpay.cash_receipt_publish_on_receipt(
        receipt_id='62e0f11f1fc192036b1b3c92',
        username='ํ…Œ์ŠคํŠธ',
        email='test@bootpay.co.kr',
        phone='01000000000',
        identity_no='01000000000',
        cash_receipt_type='์†Œ๋“๊ณต์ œ'
    )
if 'error_code' not in token:
   # ์š”์ฒญ ์„ฑ๊ณต
   print(response)

9-2. ํ˜„๊ธˆ์˜์ˆ˜์ฆ ๋ฐœํ–‰ ์ทจ์†Œ

9-1์„ ํ†ตํ•ด ๋ฐœํ–‰ํ•œ ํ˜„๊ธˆ์˜์ˆ˜์ฆ์„ ์ทจ์†Œํ•ฉ๋‹ˆ๋‹ค.

response = bootpay.cash_receipt_cancel_on_receipt(
        receipt_id='62e0f11f1fc192036b1b3c92',
    )
if 'error_code' not in token:
   # ์š”์ฒญ ์„ฑ๊ณต
   print(response)

9-3. (๋ณ„๊ฑด) ํ˜„๊ธˆ์˜์ˆ˜์ฆ ๋ฐœํ–‰

๋ถ€ํŠธํŽ˜์ด ๊ฒฐ์ œ์™€ ์ƒ๊ด€์—†์ด ๊ธˆ์•ก, ์ƒํ’ˆ๋ช…, ํ˜„๊ธˆ์˜์ˆ˜์ฆ ๋ฐœํ–‰์ •๋ณด ๋“ฑ์„ ๋ณด๋‚ด ํ˜„๊ธˆ์˜์ˆ˜์ฆ์„ ๋ฐœํ–‰ํ•˜๋Š” API ์ž…๋‹ˆ๋‹ค

 response = bootpay.request_cash_receipt(
        pg='ํ† ์Šค',
        price=1000,
        order_name='ํ…Œ์ŠคํŠธ',
        cash_receipt_type='์†Œ๋“๊ณต์ œ',
        user={
            "username": '๋ถ€ํŠธํŽ˜์ด',
            "phone": '01000000000',
            "email": "bootpay@bootpay.co.kr"
        },
        identity_no='01000000000',
        purchased_at=datetime.datetime.now().astimezone().strftime(
            '%Y-%m-%dT%H:%M:%S%z'),
        order_id=str(time.time())
    )
if 'error_code' not in token:
   # ์š”์ฒญ ์„ฑ๊ณต
   print(response)

9-4. (๋ณ„๊ฑด) ํ˜„๊ธˆ์˜์ˆ˜์ฆ ๋ฐœํ–‰ ์ทจ์†Œ

9-3์„ ํ†ตํ•ด ๋ฐœํ–‰ํ•œ ํ˜„๊ธˆ์˜์ˆ˜์ฆ์„ ์ทจ์†Œํ•ฉ๋‹ˆ๋‹ค.

response = bootpay.cancel_cash_receipt(
        receipt_id='62f20fc21fc192036b4f6f89',
        cancel_username='์‹œ์Šคํ…œ',
        cancel_message='ํ…Œ์ŠคํŠธ'
    )
if 'error_code' not in token:
   # ์š”์ฒญ ์„ฑ๊ณต
   print(response)

Example ํ”„๋กœ์ ํŠธ

์ ์šฉํ•œ ์ƒ˜ํ”Œ ํ”„๋กœ์ ํŠธ์„ ์ฐธ์กฐํ•ด์ฃผ์„ธ์š”

Documentation

๋ถ€ํŠธํŽ˜์ด ๊ฐœ๋ฐœ๋งค๋‰ด์–ผ์„ ์ฐธ์กฐํ•ด์ฃผ์„ธ์š”

๊ธฐ์ˆ ๋ฌธ์˜

๋ถ€ํŠธํŽ˜์ด ํ™ˆํŽ˜์ด์ง€ ์šฐ์ธก ํ•˜๋‹จ ์ฑ„ํŒ…์„ ํ†ตํ•ด ๊ธฐ์ˆ ๋ฌธ์˜ ์ฃผ์„ธ์š”!

License

MIT License.

About

bootpay server side plugin for python

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

ย 
ย 
ย 

Contributors

Languages