Transactions

Get Transaction

Changed on

Retrieves the status and details of a specific transaction by its ID.

get/iap/transactions/{transaction_id}

Request

  • Base URL
    https://api.zerosettle.io/v1
  • URL
    https://api.zerosettle.io/v1/iap/transactions/{transaction_id}
  • Auth
    API key in header X-ZeroSettle-Key

Path parameters

transaction_idstring required

The transaction ID (UUID returned from checkout).

Response

Transaction details

idstring

Transaction ID (UUID).

product_idstring

The product's reference ID.

status'pending' | 'processing' | 'succeeded' | 'failed' | 'refunded' | 'disputed'

Current transaction status.

source'web_checkout' | 'store_kit'

Where the transaction originated.

purchased_atstring date-time

ISO 8601 timestamp of when the purchase was made.

storekit_statusinteger nullable

StoreKit finish status: 1 = active (finished), 2 = anything-not-active (cancelled, expired, billing retry, grace period, revoked). Null for web checkout transactions. This is a coarse SDK-reported flag; consult storekit_apple_status for Apple's full state.

storekit_apple_status1 | 2 | 3 | 4 | 5 nullable

Apple's full subscription status code from the App Store Server API. 1 = Active, 2 = Expired, 3 = BillingRetry, 4 = GracePeriod, 5 = Revoked. Null when no Apple-verified state has been recorded (e.g., before the SDK has reported a state change, or when ASC credentials are not configured for the tenant).

expires_atstring date-time nullable

ISO 8601 expiry timestamp for subscription transactions. Null for one-time purchases.

Changes