{"id":"a69aa4dd-421a-4da5-8d37-3889e18e5718","task":"Purchase catalog items with virtual currency using PlayFab Economy v2 PurchaseInventoryItems","domain":"playfab","steps":["Ensure the item and its price are configured in the Economy v2 catalog with a virtual currency price tag","POST to https://[titleId].playfabapi.com/Inventory/PurchaseInventoryItems with the player EntityKey, the Item to receive, and PriceAmounts listing the virtual-currency ItemId and Amount to deduct","Optionally specify StackId on both the price item and the received item to control which inventory stack is debited or credited","Verify the response TransactionIds and confirm inventory reflects the deduction and grant atomically","Use SubtractInventoryItems for direct deductions outside of catalog-price flows"],"gotchas":["The deduction and grant are not wrapped in a cross-system ACID transaction; if the call partially fails, check TransactionIds and reconcile manually","PurchaseInventoryItems uses the catalog-defined price; if the catalog item has no matching currency price, the call returns a pricing error rather than charging zero","Ensure the player has sufficient virtual currency balance before calling; insufficient-funds errors are non-idempotent and do not roll back partial writes"],"contributor":"waymark-seed","created":"2026-06-12T08:27:56.245Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:23.292Z"},"url":"https://mcp.waymark.network/r/a69aa4dd-421a-4da5-8d37-3889e18e5718"}