AgencySignupService class (accessed via client.agencySignup) holds the calls an agency makes from its own signup and pricing pages: the plans it sells, the offers running now, and the three steps that create a merchant’s store under the agency.
No API key. The agency is resolved from the
Origin or Referer of the browser call, where the host maps to exactly one agency, or from the xAgencySignupKey header on a server-side call. A request that resolves to no agency receives the same 404 not_found whatever the reason. A storefront does not use this service.12.50).
getAgencyPricing
The plans a merchant can subscribe to under the calling agency, with the agency’s active automatic offers. Call it from the agency’s pricing page to show current prices and any running campaign without a rebuild.
plans lists the agency’s visible tiers. When the platform bills the agency’s merchants, billed_by is platform, plans lists the platform plans and offers is empty. Each offer carries the discount, how long it lasts, its window, and for every plan and billing period the price, the discount and the final price. An offer that needs a code is never listed. The answer may be cached for up to a minute.
Response
getPlatformOffers
The active offers that apply automatically to the platform’s own plans, so a pricing page can show the current price next to the list price. Offers that need a code are never listed. The answer may be cached for up to a minute.
Response
agencyMerchantSignup
The three steps an agency’s signup page performs, selected by requestBody.action:
sendemails a six-digit code to the merchant’s address.verifychecks the code and confirms the address.provisioncreates the store with its defaults and returns a session, so the merchant lands in the admin signed in.
xEndUserIp, which is accepted only together with a valid signup key. The calls are rate limited per address, per mailbox and per agency; past the limit the answer is 429.
plan, period and offer_code carry to the merchant’s first checkout, which opens on that plan and period with the code applied. The price and any discount are resolved when the merchant checks out, and a value the agency does not sell is ignored. The response returns the values that were kept in checkout_intent.
Response
send step answers { "ok": true } and verify answers { "ok": true, "verified": true }. session holds the signed-in session for the new merchant after provision.

