wshobson/paypal-통합

paypal-통합은(는) 무엇을 하나요?

PayPal 결제 처리를 통합하여 익스프레스 체크아웃, 구독, 환불 관리를 지원합니다. PayPal 결제 구현, 온라인 거래 처리, 전자상거래 체크아웃 흐름 구축 시 사용하세요.

개요

이 스킬은 PayPal REST API 및 SDK와 상호작용하여 애플리케이션에 결제 기능을 손쉽게 추가할 수 있게 해줍니다. 주요 기능은 다음과 같습니다:

• 익스프레스 체크아웃: 빠른 결제 경험 제공
• 구독 관리: 정기 결제 설정 및 관리
• 환불 처리: 전체 또는 부분 환불 지원

지원 플랫폼

• Node.js (JavaScript/TypeScript)
• Python
• 기타 언어 (별도 설정 필요)

사용 방법

1. 설치

   • Node.js: npm install paypal-rest-sdk
   • Python: pip install paypalrestsdk

2. 환경 변수 설정

   • PAYPAL_CLIENT_ID: PayPal 앱의 클라이언트 ID
   • PAYPAL_CLIENT_SECRET: PayPal 앱의 클라이언트 시크릿
   • PAYPAL_MODE: sandbox (테스트) 또는 live (실제 결제)

3. 결제 요청 예시

   const paypal = require('paypal-rest-sdk');
   
   paypal.configure({
     'mode': process.env.PAYPAL_MODE,
     'client_id': process.env.PAYPAL_CLIENT_ID,
     'client_secret': process.env.PAYPAL_CLIENT_SECRET
   });
   
   const create_payment_json = {
     "intent": "sale",
     "payer": {
       "payment_method": "paypal"
     },
     "redirect_urls": {
       "return_url": "http://localhost:3000/success",
       "cancel_url": "http://localhost:3000/cancel"
     },
     "transactions": [{
       "item_list": {
         "items": [{
           "name": "Red Sox Hat",
           "sku": "001",
           "price": "25.00",
           "currency": "USD",
           "quantity": 1
         }]
       },
       "amount": {
         "currency": "USD",
         "total": "25.00"
       },
       "description": "Hat for the best team ever"
     }]
   };
   
   paypal.payment.create(create_payment_json, function (error, payment) {
     if (error) {
       throw error;
     } else {
       console.log("Create Payment Response");
       console.log(payment);
     }
   });
   

주요 기능 상세

익스프레스 체크아웃

• POST /v1/payments/payment - 결제 생성
• GET /v1/payments/payment/<ID> - 결제 조회
• POST /v1/payments/payment/<ID>/execute - 결제 승인

구독

• POST /v1/billing/subscriptions - 구독 생성
• GET /v1/billing/subscriptions/<ID> - 구독 조회
• PATCH /v1/billing/subscriptions/<ID> - 구독 업데이트
• POST /v1/billing/subscriptions/<ID>/cancel - 구독 취소

환불

• POST /v1/payments/sale/<ID>/refund - 판매 환불
• POST /v1/payments/authorization/<ID>/void - 승인 취소

참고 자료

• PayPal 개발자 문서: https://developer.paypal.com/docs/api/overview/
• PayPal SDK GitHub: https://github.com/paypal/PayPal-node-SDK