Skip to main content

acquirePlayerCode

Acquire a free listing: writes the entitlement row (no payment edge exists in P4a — paid modes are P4b). Idempotent per (listing, caller). Allowed in any admission mode; in allow_list apps an unadmitted acquisition holds until the listing/author/org is admitted, at which point installPlayerCode proceeds.

acquirePlayerCode(
  appId: BigInt!
  listingId: String!
): PlayerCodeAcquisition!

Arguments​

acquirePlayerCode.appId ● BigInt! non-null scalar​

App that owns the listing.

acquirePlayerCode.listingId ● String! non-null scalar​

UUID of the listing to acquire.

Type​

PlayerCodeAcquisition object​

The caller's entitlement to a listing (mode 'free' in P4a). Uninstalling never deletes this row; it is the audit trail P4b attaches payment to.