feat: Adding support for Get App Transaction Info endpoint (#86)

Author: tikhop

src/api_client/api/app_store_server_api.rs

@@ -7,6 +7,7 @@ use crate::api_client::api::app_store_server_api::api_error_code::ApiErrorCode;
 use crate::api_client::api_client::{ApiClient};
 use crate::api_client::error::ApiServiceError;
 use crate::api_client::transport::Transport;
+use crate::primitives::app_transaction_info_response::AppTransactionInfoResponse;
 use crate::primitives::check_test_notification_response::CheckTestNotificationResponse;
 use crate::primitives::consumption_request::ConsumptionRequest;
 use crate::primitives::extend_renewal_date_request::ExtendRenewalDateRequest;
@@ -410,6 +411,27 @@ impl<T: Transport> AppStoreServerApiClient<T> {
         self.make_request_with_response_body(req).await
     }
 
+    /// Get a customer's app transaction information for your app.
+    ///
+    /// [Get App Transaction Info](https://developer.apple.com/documentation/appstoreserverapi/get-app-transaction-info)
+    ///
+    /// # Arguments
+    ///
+    /// * `transaction_id` - Any originalTransactionId, transactionId or appTransactionId that belongs to the customer for your app.
+    ///
+    /// # Returns
+    ///
+    /// A response that contains signed app transaction information for a customer.
+    ///
+    /// # Errors
+    ///
+    /// Returns an `APIError` if the request could not be processed.
+    pub async fn app_transaction_info(&self, transaction_id: &str) -> Result<AppTransactionInfoResponse, ApiError> {
+        let path = format!("/inApps/v1/transactions/appTransactions/{}", transaction_id);
+        let req = self.build_request::<()>(path.as_str(), Method::GET, None)?;
+        self.make_request_with_response_body(req).await
+    }
+
     /// Get a customer's in-app purchases from a receipt using the order ID.
     ///
     /// [Documentation](https://developer.apple.com/documentation/appstoreserverapi/look_up_order_id)

src/api_client/api/app_store_server_api/api_error_code.rs

@@ -239,6 +239,11 @@ pub enum ApiErrorCode {
     /// [Documentation](https://developer.apple.com/documentation/appstoreserverapi/transactionidnotfounderror)
     TransactionIdNotFound = 4040010,
 
+    /// An error response that indicates an app transaction doesn't exist for the specified customer.
+    ///
+    /// [AppTransactionDoesNotExistError](https://developer.apple.com/documentation/appstoreserverapi/apptransactiondoesnotexisterror)
+    AppTransactionDoesNotExist = 4040019,
+
     /// An error that indicates that the request exceeded the rate limit.
     /// [Documentation](https://developer.apple.com/documentation/appstoreserverapi/ratelimitexceedederror)
     RateLimitExceeded = 4290000,

src/primitives/app_transaction_info_response.rs

@@ -0,0 +1,15 @@
+// Copyright (c) 2025 Apple Inc. Licensed under MIT License.
+
+use serde::{Deserialize, Serialize};
+
+/// A response that contains signed app transaction information for a customer.
+///
+/// [AppTransactionInfoResponse](https://developer.apple.com/documentation/appstoreserverapi/apptransactioninforesponse)
+#[derive(Debug, Clone, Deserialize, Serialize, Hash)]
+pub struct AppTransactionInfoResponse {
+    /// A customer's app transaction information, signed by Apple, in JSON Web Signature (JWS) format.
+    ///
+    /// [JWSAppTransaction](https://developer.apple.com/documentation/appstoreserverapi/jwsapptransaction)
+    #[serde(rename = "signedAppTransactionInfo")]
+    pub signed_app_transaction_info: Option<String>,
+}

src/primitives/mod.rs

@@ -1,5 +1,6 @@
 pub mod account_tenure;
 pub mod app_transaction;
+pub mod app_transaction_info_response;
 pub mod auto_renew_status;
 pub mod check_test_notification_response;
 pub mod consumption_request;

tests/ass_api_client.rs

@@ -632,6 +632,93 @@ async fn test_get_transaction_info() {
     );
 }
 
+#[tokio::test]
+async fn test_app_transaction_info() {
+    let client = app_store_server_api_client_with_body_from_file(
+        "tests/resources/models/appTransactionInfoResponse.json",
+        StatusCode::OK,
+        Some(Box::new(|req, body| {
+            assert_eq!(&Method::GET, req.method());
+            assert_eq!(
+                "https://local-testing-base-url/inApps/v1/transactions/appTransactions/1234",
+                req.uri().to_string()
+            );
+            assert!(body.is_empty(), "GET request should have empty body");
+        })),
+    );
+
+    let response = client
+        .app_transaction_info("1234")
+        .await
+        .unwrap();
+    assert_eq!(
+        "signed_app_transaction_info_value",
+        response
+            .signed_app_transaction_info
+            .unwrap()
+    );
+}
+
+#[tokio::test]
+async fn test_app_transaction_info_invalid_transaction_id() {
+    let client = app_store_server_api_client_with_body_from_file(
+        "tests/resources/models/invalidTransactionIdError.json",
+        StatusCode::BAD_REQUEST,
+        None,
+    );
+
+    let result = client
+        .app_transaction_info("invalid_id")
+        .await;
+
+    assert!(result.is_err());
+    let err = result.unwrap_err();
+    assert_eq!(400, err.http_status_code);
+    assert_eq!(Some(ApiErrorCode::InvalidTransactionId), err.api_error);
+    assert_eq!(Some(4000006), err.error_code);
+    assert_eq!(Some("Invalid transaction id.".to_string()), err.error_message);
+}
+
+#[tokio::test]
+async fn test_app_transaction_info_transaction_id_not_found() {
+    let client = app_store_server_api_client_with_body_from_file(
+        "tests/resources/models/transactionIdNotFoundError.json",
+        StatusCode::NOT_FOUND,
+        None,
+    );
+
+    let result = client
+        .app_transaction_info("not_found_id")
+        .await;
+
+    assert!(result.is_err());
+    let err = result.unwrap_err();
+    assert_eq!(404, err.http_status_code);
+    assert_eq!(Some(ApiErrorCode::TransactionIdNotFound), err.api_error);
+    assert_eq!(Some(4040010), err.error_code);
+    assert_eq!(Some("Transaction id not found.".to_string()), err.error_message);
+}
+
+#[tokio::test]
+async fn test_app_transaction_info_app_transaction_does_not_exist() {
+    let client = app_store_server_api_client_with_body_from_file(
+        "tests/resources/models/appTransactionDoesNotExistError.json",
+        StatusCode::NOT_FOUND,
+        None,
+    );
+
+    let result = client
+        .app_transaction_info("no_app_transaction")
+        .await;
+
+    assert!(result.is_err());
+    let err = result.unwrap_err();
+    assert_eq!(404, err.http_status_code);
+    assert_eq!(Some(ApiErrorCode::AppTransactionDoesNotExist), err.api_error);
+    assert_eq!(Some(4040019), err.error_code);
+    assert_eq!(Some("No AppTransaction exists for the customer.".to_string()), err.error_message);
+}
+
 #[tokio::test]
 async fn test_look_up_order_id() {
     let client = app_store_server_api_client_with_body_from_file(

tests/resources/models/appTransactionDoesNotExistError.json

@@ -0,0 +1,4 @@
+{
+   "errorCode": 4040019,
+   "errorMessage": "No AppTransaction exists for the customer."
+}

tests/resources/models/appTransactionInfoResponse.json

@@ -0,0 +1,3 @@
+{
+    "signedAppTransactionInfo": "signed_app_transaction_info_value"
+}

tests/resources/models/invalidTransactionIdError.json

@@ -0,0 +1,4 @@
+{
+   "errorCode": 4000006,
+   "errorMessage": "Invalid transaction id."
+}

tests/resources/models/transactionIdNotFoundError.json

@@ -0,0 +1,4 @@
+{
+   "errorCode": 4040010,
+   "errorMessage": "Transaction id not found."
+}