DjangoRestFramework 토스페이먼츠 결제 연동하기

참고

purchase == order == 주문

payment == 결제

import uuid

class Purchase(BaseModel): # or OrderSomething
	order_id = models.UUIDField(verbose_name="토스페이먼츠에 사용할 orderId 개념", default=uuid.uuid4)

def camel_to_snake(name):
    name = re.sub("(.)([A-Z][a-z]+)", r"\1_\2", name)
    return re.sub("([a-z0-9])([A-Z])", r"\1_\2", name).lower()

def get_headers_from_secret_key():
    secret_key = settings.TOSS_PAYMENT_SECRET
    userpass = secret_key + ":"
    encoded_secret = base64.b64encode(userpass.encode()).decode()
    headers = {"Authorization": "Basic %s" % encoded_secret, "Content-Type": "application/json"}
    return headers

def request_payment_confirm(order_id, amount, payment_key):
    headers = get_headers_from_secret_key()
    request_url = "https://api.tosspayments.com/v1/payments/confirm"
    response = requests.post(
        request_url,
        data=json.dumps(
            {
                "orderId": order_id,
                "amount": amount,
                "paymentKey": payment_key,
            }
        ),
        headers=headers,
    )
    response_json = response.json()

    return response, response_json

{
  'm_id': '(상점아이디)',
  'last_transaction_key': '(거래키값)',
  'payment_key': '(결제키 값)',
  'order_id': '(주문 id)',
  'order_name': '(주문 명)',
  'tax_exemption_amount': '(과세 제외 결제 금액)',
  'status': '(결제 처리 상태)',
  'requested_at': '(결제가 일어난 시간)',
  'approved_at': '(결제가 승인된 시간)',
  'use_escrow': '(에스크로 사용여부)',
  'culture_expense': '(문화비 지출여부)',
  'card': {
    'issuerCode': '(카드 발급사 코드)',
    'acquirerCode': '(카드 매입사 코드)',
    'number': '(카드 번호)',
    'installmentPlanMonths': '(할부 개월 수)',
    'isInterestFree': '(무이자 여부)',
    'interestPayer': '(이자 납부자)',
    'approveNo': '(승인 번호)',
    'useCardPoint': '(카드 포인트 사용 여부)',
    'cardType': '(카드 종류)',
    'ownerType': '(소유자 종류)',
    'acquireStatus': '(카드 승인 상태)',
    'amount': '(결제 금액)'
  },
  'virtual_account': '(가상계좌 정보)',
  'transfer': '(계좌이체 결제 시 이체 정보)',
  'mobile_phone': '(휴대폰 결제 정보)',
  'gift_certificate': '(문화비 지출 여부)',
  'cash_receipt': '(현금영수증 결제 정보)',
  'cash_receipts': '(현금영수증 발행 및 취소 정보)',
  'discount': '(카드사 즉시 할인 프로모션 정보)',
  'cancels': '(결제 취소 이력)',
  'secret': '(가상계좌 웹훅 확인)',
  'type': '(결제 타입 정보)',
  'easy_pay': {
    'provider': '(간편결제 제공자)',
    'amount': '(간편결제 금액)',
    'discountAmount': '(간편결제 할인 금액)'
  },
  'country': '(결제 국가)',
  'failure': '(결제 승인 실패)',
  'is_partial_cancelable': '(부분 취소 가능 여부)',
  'receipt': {
    'url': '(영수증 URL)'
  },
  'checkout': {
    'url': '(결제창 URL)'
  },
  'currency': '(결제 통화)',
  'total_amount': '(총 결제 금액)',
  'balance_amount': '(취소 가능한 금액)',
  'supplied_amount': '(공급가액)',
  'vat': '(부가세)',
  'tax_free_amount': '(면세 금액)',
  'method': '(결제수단)',
  'version': '(Payment 응답 버전)',
  'metadata': '(메타데이터)'
}

# *last_update(240913)* - metadata 추가

logger = logging.getLogger("request")

class PaymentSerializer(serializers.ModelSerializer):
    user = serializers.CharField(read_only=True)
    payment_key = serializers.CharField()
    order_id = serializers.CharField(label="purchase 의 order id")
    total_amount = serializers.IntegerField(label="결제 금액")

    class Meta:
        model = Payment
        fields = [
            "id",
            "user",
            "payment_key",
            "order_id",
            (생략)
            ]

        read_only_fields = [
	          (생략)
        ]

    def validate(self, attrs):
        attrs = super().validate(attrs)
        validate_request_user(self, attrs)

				# 프론트엔드에서 전달받은 값
        order_id = attrs.get("order_id")
        total_amount = attrs.get("total_amount")
        payment_key = attrs.get("payment_key")

				...(생략)...

				# confirm API 요청
        response, response_data = request_payment_confirm(
            order_id,
            total_amount,
            payment_key,
        )
        if response.status_code != 200:
            self._handle_payment_failure(purchase_obj, response_data)
            raise ValidationError(response_data)

        attrs["purchase_obj"] = purchase_obj
        attrs["response_data"] = response_data

        return attrs

    @transaction.atomic()
    def create(self, validated_data):

        purchase_obj = validated_data["purchase_obj"]
        user_obj = validated_data["user"]
        response_data = validated_data["response_data"]

        # confirm 이 완료된 경우 payment 저장 및 프론트엔드로 전달
        response_data_snake = {camel_to_snake(key): value for key, value in response_data.items()}
        ...(생략)...
        filtered_data = {key: value for key, value in response_data_snake.items() if key in payment_fields}
        instance = Payment.objects.create(purchase=purchase_obj, user=user_obj, **filtered_data)


				...(생략)...

        return instance