Payment intent endpoint

apps/api/src/donations/donations.controller.ts

@@ -1,5 +1,4 @@
-import { RealmViewSupporters, ViewSupporters } from '@podkrepi-bg/podkrepi-types'
-import { AuthenticatedUser, Public, RoleMatchingMode, Roles } from 'nest-keycloak-connect'
+import { Response } from 'express'
 import {
   Body,
   Controller,
@@ -11,18 +10,19 @@ import {
   Query,
   Res,
 } from '@nestjs/common'
-import { ApiQuery } from '@nestjs/swagger'
-import { Response } from 'express'
+import { ApiQuery, ApiTags } from '@nestjs/swagger'
+import { DonationStatus } from '@prisma/client'
+import { AuthenticatedUser, Public, RoleMatchingMode, Roles } from 'nest-keycloak-connect'
 
+import { RealmViewSupporters, ViewSupporters } from '@podkrepi-bg/podkrepi-types'
 import { isAdmin, KeycloakTokenParsed } from '../auth/keycloak'
 import { DonationsService } from './donations.service'
 import { CreateSessionDto } from './dto/create-session.dto'
 import { CreatePaymentDto } from './dto/create-payment.dto'
 import { UpdatePaymentDto } from './dto/update-payment.dto'
 import { CreateBankPaymentDto } from './dto/create-bank-payment.dto'
-import { DonationStatus } from '@prisma/client'
+import { CreatePaymentIntentDto } from './dto/create-payment-intent.dto'
 import { PagingQueryDto } from '../common/dto/paging-query-dto'
-import { ApiTags } from '@nestjs/swagger'
 
 @ApiTags('donation')
 @Controller('donation')
@@ -135,6 +135,15 @@ export class DonationsController {
     return this.donationsService.create(createPaymentDto, user)
   }
 
+  @Post('create-payment-intent')
+  @Public()
+  createPaymentIntent(
+    @Body()
+    createPaymentIntentDto: CreatePaymentIntentDto,
+  ) {
+    return this.donationsService.createPaymentIntent(createPaymentIntentDto)
+  }
+
   @Post('create-bank-payment')
   @Roles({
     roles: [RealmViewSupporters.role, ViewSupporters.role],

apps/api/src/donations/donations.service.ts

@@ -237,6 +237,12 @@ export class DonationsService {
     return result
   }
 
+  /**
+   *  Get donation by id
+   * @param id Donation id
+   * @returns  {Promise<Donation>} Donation
+   * @throws NotFoundException if no donation is found
+   */
   async getDonationById(id: string): Promise<Donation> {
     try {
       const donation = await this.prisma.donation.findFirst({
@@ -251,6 +257,12 @@ export class DonationsService {
     }
   }
 
+  /**
+   * Get donation by id with person data attached
+   * @param id Donation id
+   * @param keycloakId Keycloak id of the user
+   * @returns {Promise<Donation & { person: Person | null }>} Donation
+   */
   async getUserDonationById(
     id: string,
     keycloakId: string,
@@ -281,6 +293,12 @@ export class DonationsService {
     })
   }
 
+  /** Describe the function below
+   * @param inputDto
+   * @param user
+   * @returns {Promise<Donation>}
+   *
+   */
   async create(inputDto: CreatePaymentDto, user: KeycloakTokenParsed): Promise<Donation> {
     const donation = await this.prisma.donation.create({ data: inputDto.toEntity(user) })
 
@@ -291,6 +309,17 @@ export class DonationsService {
     return donation
   }
 
+  /**
+   * Create a payment intent for a donation
+   * @param inputDto Payment intent create params
+   * @returns {Promise<Stripe.Response<Stripe.PaymentIntent>>}
+   */
+  async createPaymentIntent(
+    inputDto: Stripe.PaymentIntentCreateParams,
+  ): Promise<Stripe.Response<Stripe.PaymentIntent>> {
+    return this.stripeClient.paymentIntents.create(inputDto)
+  }
+
   /**
    * Used by the administrators to manually add donations executed by bank payments to a campaign.
    */
@@ -435,6 +464,9 @@ export class DonationsService {
     })
   }
 
+  /**
+   *  @param res  - Response object to be used for the export to excel file
+   */
   async exportToExcel(res: Response) {
     const { items } = await this.listDonations()
     const donationsMappedForExport = items.map((donation) => ({

apps/api/src/donations/dto/create-payment-intent.dto.ts

@@ -0,0 +1,16 @@
+import Stripe from 'stripe'
+import { ApiProperty } from '@nestjs/swagger'
+import { Currency } from '@prisma/client'
+import { Expose } from 'class-transformer'
+import { IsNumber } from 'class-validator'
+
+export class CreatePaymentIntentDto implements Stripe.PaymentIntentCreateParams {
+  @ApiProperty()
+  @Expose()
+  @IsNumber()
+  amount: number
+
+  @ApiProperty()
+  @Expose()
+  currency: Currency
+}