feat(card-service): handle payment cancelled & funded events

localenv/cloud-nine-wallet/docker-compose.yml

@@ -156,6 +156,7 @@ services:
       KEY_ID: 7097F83B-CB84-469E-96C6-2141C72E22C0
       OPERATOR_TENANT_ID: 438fa74a-fa7d-4317-9ced-dde32ece1787
       CARD_SERVICE_URL: 'http://cloud-nine-wallet-card-service:3007'
+      CARD_WEBHOOK_SERVICE_URL: 'http://cloud-nine-wallet-card-service:3007/payment-event'
     depends_on:
       - shared-database
       - shared-redis

packages/backend/src/graphql/schema.graphql

@@ -1252,6 +1252,7 @@ input CancelOutgoingPaymentInput {
 
 enum CardPaymentFailureReason {
   invalid_signature
+  invalid_request
 }
 
 input CreateOutgoingPaymentFromIncomingPaymentInput {

packages/backend/src/open_payments/payment/outgoing/service.ts

@@ -213,7 +213,7 @@ export type CancelOutgoingPaymentOptions = {
   id: string
   tenantId: string
   reason?: string
-  cardPaymentFailureReason?: 'invalid_signature'
+  cardPaymentFailureReason?: 'invalid_signature' | 'invalid_request'
 }
 
 export type CreateOutgoingPaymentOptions =
@@ -264,7 +264,7 @@ async function cancelOutgoingPayment(
             : {})
         }
       })
-      .withGraphFetched('quote')
+      .withGraphFetched('[quote, cardDetails]')
     const asset = await deps.assetService.get(payment.quote.assetId)
     if (asset) payment.quote.asset = asset
 
@@ -719,7 +719,7 @@ async function fundPayment(
         tenantId
       })
       .forUpdate()
-      .withGraphFetched('quote')
+      .withGraphFetched('[quote, cardDetails]')
     if (!payment) return FundingError.UnknownPayment
 
     const asset = await deps.assetService.get(payment.quote.assetId)

packages/card-service/src/app.ts

@@ -9,10 +9,12 @@ import cors from '@koa/cors'
 import { createValidatorMiddleware, HttpMethod } from '@interledger/openapi'
 import { PaymentContext } from './payment/types'
 import { PaymentEventContext } from './payment/types'
+import { PaymentRoutes } from './payment/routes'
 
 export interface AppServices {
   logger: Promise<Logger>
   config: Promise<IAppConfig>
+  paymentRoutes: Promise<PaymentRoutes>
 }
 
 export type AppContainer = IocContract<AppServices>

packages/card-service/src/openapi/specs/card-server.yaml

@@ -54,17 +54,46 @@ paths:
             application/json:
               schema:
                 type: object
+                required:
+                  - requestId
+                  - result
                 properties:
                   requestId:
                     type: string
+                    format: uuid
                   result:
-                    type: string
-                    enum:
-                      - approved
+                    type: object
+                    required:
+                      - code
+                    properties:
+                      code:
+                        type: string
+                        enum:
+                          - approved
+                          - invalid_signature
+                      description:
+                        type: string
         '400':
           description: Invalid request
-        '401':
-          description: Card expired or invalid signature
+          content:
+            application/json:
+              schema:
+                type: object
+                required:
+                  - error
+                properties:
+                  error:
+                    type: object
+                    required:
+                      - code
+                      - description
+                    properties:
+                      code:
+                        type: string
+                        enum:
+                          - invalid_request
+                      description:
+                        type: string
         '500':
           description: Internal server error
   /payment-event:
@@ -78,31 +107,54 @@ paths:
             schema:
               type: object
               required:
-                - requestId
-                - outgoingPaymentId
-                - result
+                - id
+                - type
+                - data
               properties:
-                requestId:
+                id:
                   type: string
                   format: uuid
-                outgoingPaymentId:
+                type:
                   type: string
-                  format: uuid
-                result:
+                  enum:
+                    - outgoing_payment.funded
+                    - outgoing_payment.cancelled
+                data:
                   type: object
                   required:
-                    - code
+                    - id
+                    - cardDetails
                   properties:
-                    code:
+                    id:
                       type: string
-                      enum:
-                        - completed
-                        - card_expired
-                        - invalid_signature
+                      format: uuid
+                    cardDetails:
+                      type: object
+                      required:
+                        - requestId
+                      properties:
+                        requestId:
+                          type: string
+                          format: uuid
+                        initiatedAt:
+                          type: string
+                          format: date-time
+                        data:
+                          type: object
+                          additionalProperties: true
+                      additionalProperties: true
+                    metadata:
+                      type: object
+                      properties:
+                        cardPaymentFailureReason:
+                          type: string
+                          enum:
+                            - invalid_signature
+                            - invalid_request
+                      additionalProperties: true
+                  additionalProperties: true
       responses:
-        '202':
-          description: Payment event accepted and forwarded
+        '200':
+          description: Payment event accepted
         '400':
           description: Malformed request body
-        '404':
-          description: Request not found