Feat: add endpoint to retrieve payment request by nonce (#963)

* add endoint to retrieve payment request by nonce

Author: volodymyr-basiuk

api/api.yaml

@@ -1862,6 +1862,32 @@ paths:
           $ref: '#/components/responses/400'
         '500':
           $ref: '#/components/responses/500'
+  
+  /v2/identities/{identifier}/payment-request/nonce/{nonce}:
+    get:
+      summary: Get Payment Request By Nonce
+      operationId: GetPaymentRequestByNonce
+      description: Get a specific payment request for the provided identity by nonce.
+      tags:
+        - Payment
+      security:
+        - basicAuth: [ ]
+      parameters:
+        - $ref: '#/components/parameters/pathIdentifier'
+        - $ref: '#/components/parameters/pathPaymentNonce'
+      responses:
+        '200':
+          description: Retrieve a payment request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/CreatePaymentRequestResponse'
+        '400':
+          $ref: '#/components/responses/400'
+        '404':
+          $ref: '#/components/responses/404'
+        '500':
+          $ref: '#/components/responses/500'
 
   /v2/payment/settings:
     get:
@@ -3526,6 +3552,13 @@ components:
       schema:
         type: string
 
+    pathPaymentNonce:
+      name: nonce
+      in: path
+      required: true
+      description: Payment nonce
+      schema:
+        type: string
 
   responses:
     '400':

internal/api/api.gen.go

@@ -176,6 +176,26 @@ func (s *Server) GetPaymentRequest(ctx context.Context, request GetPaymentReques
 	return GetPaymentRequest200JSONResponse(toCreatePaymentRequestResponse(ctx, paymentRequest)), nil
 }
 
+// GetPaymentRequestByNonce is the controller to get payment request by nonce
+func (s *Server) GetPaymentRequestByNonce(ctx context.Context, request GetPaymentRequestByNonceRequestObject) (GetPaymentRequestByNonceResponseObject, error) {
+	issuerDID, err := w3c.ParseDID(request.Identifier)
+	if err != nil {
+		log.Error(ctx, "parsing issuer did", "err", err, "did", request.Identifier)
+		return GetPaymentRequestByNonce400JSONResponse{N400JSONResponse{Message: "invalid issuer did"}}, nil
+	}
+	const base10 = 10
+	nonce, ok := new(big.Int).SetString(request.Nonce, base10)
+	if !ok {
+		log.Error(ctx, "parsing nonce on get payment request by nonce", "nonce", request.Nonce)
+		return GetPaymentRequestByNonce400JSONResponse{N400JSONResponse{Message: fmt.Sprintf("invalid nonce: <%s>", request.Nonce)}}, nil
+	}
+	paymentRequest, err := s.paymentService.GetPaymentRequestByNonce(ctx, issuerDID, nonce)
+	if err != nil {
+		return GetPaymentRequestByNonce500JSONResponse{N500JSONResponse{Message: fmt.Sprintf("can't get payment-request: %s", err)}}, nil
+	}
+	return GetPaymentRequestByNonce200JSONResponse(toCreatePaymentRequestResponse(ctx, paymentRequest)), nil
+}
+
 // DeletePaymentRequest is the controller to delete payment request
 func (s *Server) DeletePaymentRequest(ctx context.Context, request DeletePaymentRequestRequestObject) (DeletePaymentRequestResponseObject, error) {
 	issuerDID, err := w3c.ParseDID(request.Identifier)

internal/api/payment.go

@@ -43,6 +43,7 @@ type PaymentService interface {
 	CreatePaymentRequest(ctx context.Context, req *CreatePaymentRequestReq) (*domain.PaymentRequest, error)
 	GetPaymentRequests(ctx context.Context, issuerDID *w3c.DID, queryParams *domain.PaymentRequestsQueryParams) ([]domain.PaymentRequest, error)
 	GetPaymentRequest(ctx context.Context, issuerDID *w3c.DID, id uuid.UUID) (*domain.PaymentRequest, error)
+	GetPaymentRequestByNonce(ctx context.Context, issuerDID *w3c.DID, nonce *big.Int) (*domain.PaymentRequest, error)
 	DeletePaymentRequest(ctx context.Context, issuerDID *w3c.DID, id uuid.UUID) error
 	CreatePaymentRequestForProposalRequest(ctx context.Context, proposalRequest *protocol.CredentialsProposalRequestMessage) (*comm.BasicMessage, error)
 	GetSettings() payments.Config

internal/core/ports/payment_service.go

@@ -235,6 +235,23 @@ func (p *payment) GetPaymentRequest(ctx context.Context, issuerDID *w3c.DID, ID
 	return paymentRequests, nil
 }
 
+// GetPaymentRequestByNonce returns payment request by nonce and issuer DID
+func (p *payment) GetPaymentRequestByNonce(ctx context.Context, issuerDID *w3c.DID, nonce *big.Int) (*domain.PaymentRequest, error) {
+	paymentReqItem, err := p.paymentsStore.GetPaymentRequestItem(ctx, *issuerDID, nonce)
+	if err != nil {
+		log.Error(ctx, "failed to get payment request item by nonce", "err", err, "issuerDID", issuerDID, "nonce", nonce)
+		return nil, fmt.Errorf("failed to get payment request item by nonce: %w", err)
+	}
+
+	paymentReq, err := p.paymentsStore.GetPaymentRequestByID(ctx, *issuerDID, paymentReqItem.PaymentRequestID)
+	if err != nil {
+		log.Error(ctx, "failed to get payment request by ID", "err", err, "issuerDID", issuerDID, "paymentRequestID", paymentReqItem.PaymentRequestID)
+		return nil, fmt.Errorf("failed to get payment request by ID: %w", err)
+	}
+
+	return paymentReq, nil
+}
+
 // DeletePaymentRequest deletes a payment request
 func (p *payment) DeletePaymentRequest(ctx context.Context, issuerDID *w3c.DID, ID uuid.UUID) error {
 	err := p.paymentsStore.DeletePaymentRequest(ctx, *issuerDID, ID)