In-depth integration tasks

These jobs are separate. Choose the operation that matches the data or outcome your application needs; none is an automatic prerequisite for every checkout.

NeedStart hereMeaning / limit
Country choices for a formCountriesConfigured country/state rows or conditional global user-country text; selected is an IP suggestion/fallback.
Existing supplied resource fileFile downloadEmail/hash selection, direct bytes and attempted counter write; no member/resource ownership check.
Currency labelsCurrencyDisplay configured labels; no conversion or provider acceptance guarantee.
Language choices / one known languageLanguage list / detailStored language metadata, with no default active/resource filter.
IP-derived suggestionsGeoinfoNullable suggestions; external lookup/cache/logging, no proof of residence.
Admin-prefixed country/currency readCountries / currencyThese registrations also permit guests; prefix alone does not grant or require admin permission.
Supplied reCAPTCHA tokenValidateRequired resource/enabled configuration; provider success interpretation only.
Record an application requestAccount requestStores request and attempts queue event; no member provisioning.
Intended payment for a saved applicationAccount paymentProvider customer/charge attempt; retries can duplicate charges.
Wallkit service pricing-plan choicesService pricing plansResource billing/features, not publisher content Pricings.

Which kind of plan does the application need?

ConceptMeaningReader action
Publisher Plan and its PricingsCatalog choices used for member content/membership access. Each Plan has many Pricings.Use the catalog/access map and existing User subscriptions and Pricing selection.
Wallkit service pricing planA separate configuration template for resource billing and service capabilities, with monthly price, transaction fee, signup/support allowances and paywall/event/reader-ID flags.The pricing-plan listing describes service-plan choices; no member entitlement or universal money-unit/currency promise follows from it.

Service pricing-plan fields are copied into a resource billing/configuration record in the existing administration model. They are not publisher Plan/Pricing IDs and must not be supplied as member checkout item_key. This comparison describes the distinct meaning; it does not add an administration setup operation.

Currency labels, language list/detail and IP suggestions serve separate selection/display jobs. The admin-prefixed country/currency registrations remain guest-readable in this source; prefix alone does not establish authorization. Geoinfo can transmit the lookup and request IP to an external service and cache/log results; handle unknown suggestions without fabricating location.

What follows an account-request acknowledgement?

The creation example records an application for two websites and returns account_id 8001. That value identifies the application record. It does not establish a user account, member token or content entitlement. The acknowledgement does not confirm queue delivery or completion by the downstream handler.

Only if your application intends payment for this request, read the payment prerequisites, then the paired example using 8001. The provider calls create a customer and charge before the final unchecked save. A payment error can follow provider effects, while an acknowledgement can follow local persistence failure. Reconcile uncertain results with the integration owner before another attempt. No automatic payment, refund, account provisioning or content-access step follows.

Diagram of What follows an account-request acknowledgement?
Open full diagram · Read diagram text
flowchart TD
    A[Submit application] --> B[Save request record]
    B --> C[Attempt queue event]
    C --> D[Return request ID]
    D --> E{Application intends payment?}
    E -->|No| F[Retain acknowledgement]
    E -->|Yes| G[Submit ID and provider token]
    G --> H[Attempt token save and refresh]
    H --> I[Create provider customer]
    I --> J[Calculate amount and create charge]
    J --> K[Attempt result save]
    K --> L[Return payment acknowledgement]

This diagram shows the usual sequence. A failure can stop it after a record change or provider action. Queue failures can be caught, and failed token/result saves do not always stop the request. The payment acknowledgement carries no settlement status. Neither path creates member identity or makes an access decision.

Keep credentials with their own task

Supplied valueUsed forMeaning
Resource public keyreCAPTCHA validation and optional localization contextSelects configuration; not a member identity or download credential.
Client reCAPTCHA tokenreCAPTCHA validation bodyProvider verification input; not a Wallkit session.
Email plus file hashResource-file download queryPair selects the existing file record; no member/resource ownership check.
account_idOptional account-request payment bodyApplication record ID; no ownership proof.
Provider tokenAccount-request payment bodyProvider-specific source input; not a Wallkit member token or local saved payment-source ID.

For a publisher Pricing purchase, use the separate User subscriptions and Pricing selection. These supporting tasks are not a required checkout sequence.

Full diagram

Use the arrow keys to scroll. Escape closes this view.

Search documentation

Enter at least 2 characters.

    ↑ ↓ move through results · Enter opens · Escape closes