Account requests and optional payment

Record an application request

POST /api/v1/account-requests

Save submitted contact/application fields, then attempt an account_request queue event. There is no duplicate guard or idempotency key. Repeating the submission can create another record.

Before you call

Use the account-request context. The action saves an AccountRequests record with server timestamps and REMOTE_ADDR IP, then attempts a queue event carrying its ID, email, plan and fixed resource ID. Queue transmission failure can be swallowed; an acknowledgement does not prove delivery or downstream processing. A later failure can leave the saved record in place.

No active email call or account/user provisioning occurs in this action. An optional Stripe token is stored here, with no provider call. Plan is only a required string: there is no service-pricing-plan lookup or closed enum validation.

Request

Content-Type: application/json; truthy decoded body required. Submit an object with these fields. Presence validators run before storage sanitization; there is no explicit strict JSON-type or length validation for the required strings.

Result

HTTP 200 JSON fields use the request-result table. account_id identifies the saved application record; message acknowledges the application path. No user/session, provider result or public record details are serialized.

curl -X POST "${WALLKIT_API_BASE}/api/v1/account-requests" \
  -H "Content-Type: application/json" \
  --data-raw '{"first_name": "Alex", "last_name": "Reader", "company_name": "Example Media", "job_title": "Publisher", "email": "reader@example.com", "plan": "pro-early", "number_of_websites": 2, "terms_and_conditions": true}'

const response = await fetch(`${process.env.WALLKIT_API_BASE}/api/v1/account-requests`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({"first_name": "Alex", "last_name": "Reader", "company_name": "Example Media", "job_title": "Publisher", "email": "reader@example.com", "plan": "pro-early", "number_of_websites": 2, "terms_and_conditions": true})
});
console.log(response.status, await response.json());

import os, json
from urllib.request import Request, urlopen
from urllib.error import HTTPError

body = {'first_name': 'Alex', 'last_name': 'Reader', 'company_name': 'Example Media', 'job_title': 'Publisher', 'email': 'reader@example.com', 'plan': 'pro-early', 'number_of_websites': 2, 'terms_and_conditions': True}
request = Request(os.environ["WALLKIT_API_BASE"] + "/api/v1/account-requests",
    data=json.dumps(body).encode("utf-8"),
    headers={"Content-Type": "application/json"}, method="POST")
try:
    with urlopen(request) as response:
        print(response.status, json.load(response))
except HTTPError as error:
    print(error.code, json.load(error))

{
  "account_id": 8001,
  "message": "Thank you! Wallkit Limited Beta: Application Successful!"
}

{
  "error": "account_request_create_error",
  "error_description": "Error creating account request"
}

Attempt payment for an existing request

POST /api/v1/account-requests-payment

Create a Stripe customer and charge for an existing account-request record. The action has no already-paid guard or idempotency key: retrying can create another customer and charge.

Before you call

Use the account-request context and the account_id returned by request creation. The action checks required input presence, then selects AccountRequests directly by the supplied account_id; it has no ownership/resource check or explicit numeric validation. Supply only the intended integer record ID.

Provide an existing provider token for this deployment’s Stripe integration. The server uses its ACCOUNT_REQUST_STRIPE_PRIVATE_KEY configuration (spelling preserved); that key determines provider account/mode. This action does not select the resource’s default payment provider or payments_in_live_mode and accepts no mode flag.

It first replaces/stores stripe_token and refreshes the record. A failed token save is logged without stopping, so the refreshed token can be the previously stored value. It then creates a Stripe customer with stored email/token, calculates amount and creates a charge. Final customer/charge persistence failure is also logged without stopping. Provider writes can precede local failure; no enclosing transaction, rollback or refund guarantee. No active email/payment-event call or Purchases/Transactions/membership creation occurs here.

Request

Content-Type: application/json; truthy decoded body required.

Charge amount is 19900 multiplied by the stored number_of_websites, passed without conversion, with currency USD. pro-early, pro and every other plan label currently select the same 19900 value. The action supplies no independent amount/unit validation; this documents the provider argument, not a universal Wallkit money unit or configurable service-plan price.

Result

HTTP 200 JSON fields use the request-result table. The acknowledgement follows provider customer/charge returns and attempted persistence. The action does not inspect charge status, paid/captured or settlement. Provider customer/charge objects and amount are not exposed in the result.

curl -X POST "${WALLKIT_API_BASE}/api/v1/account-requests-payment" \
  -H "Content-Type: application/json" \
  --data-raw '{"account_id": 8001, "stripe_token": "SYNTHETIC_PROVIDER_TOKEN"}'

const response = await fetch(`${process.env.WALLKIT_API_BASE}/api/v1/account-requests-payment`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({"account_id": 8001, "stripe_token": "SYNTHETIC_PROVIDER_TOKEN"})
});
console.log(response.status, await response.json());

import os, json
from urllib.request import Request, urlopen
from urllib.error import HTTPError

body = {'account_id': 8001, 'stripe_token': 'SYNTHETIC_PROVIDER_TOKEN'}
request = Request(os.environ["WALLKIT_API_BASE"] + "/api/v1/account-requests-payment",
    data=json.dumps(body).encode("utf-8"),
    headers={"Content-Type": "application/json"}, method="POST")
try:
    with urlopen(request) as response:
        print(response.status, json.load(response))
except HTTPError as error:
    print(error.code, json.load(error))

{
  "account_id": 8001,
  "message": "Thank you! Wallkit Early Bird: Successfully Signed Up!"
}

{
  "error": "account_request_payment_error",
  "error_description": "Error payment account request"
}