0Bit Documentation

Go-live checklist

Review the product, legal, compliance, engineering, and support gates before launching 0Base.

The 0Base go-live checklist is the final operational checklist before customers can use a merchant checkout. It should prove the flow is not just visually ready, but supportable, recoverable, reconcilable, and honest about account-gated availability.

0Base availability is account-gated. Build against capabilities, merchant status, environment mode, and settlement settings instead of assuming that every payment method, asset, network, cadence, or refund path is enabled for every merchant.

0Base product docs and API details

These pages are public product guidance for merchant and platform developers. 0Base endpoint-level API pages are not published for partners yet; use this product documentation to understand the workflow, records, and launch boundaries.

End-to-end picture

This flow is intentionally shown as product infrastructure: Product scope -> Account gates -> Lifecycle tests -> Webhook tests -> Finance tests -> Launch/rollback. The merchant application can make the customer experience simple, but the backend should keep each step visible enough for retries, support, and finance closeout.

Production contract

BoundaryWhat to buildWhy it matters
ScopeDefine which checkout surfaces, assets, networks, markets, and merchants are included.Prevents accidental broad launch.
Account gatesConfirm merchant/account status, capabilities, settings, and keys.Live access is not inferred from code.
Lifecycle testsRun success, expiry, failure, duplicate retry, delayed webhook, and report closeout.Real production issues are rarely only success paths.
Operational contactsName support, finance, engineering, and rollback contacts.Launch needs named points of contact as well as code.
Public copyReview customer and developer-facing claims.Docs and UI should not overpromise live behavior.

Status and state handling

StateWhat it meansDeveloper action
Not readyRequired gate/test/owner missing.Do not launch.
Ready for controlled launchAll critical gates pass.Enable limited production.
MonitoringProduction is live and watched.Track payment, webhook, and ledger health.
RollbackIssue requires disabling exposure.Use feature flag and preserve records.

Status handling should be strict even when the customer UI is friendly. Store raw 0Base statuses, map them to customer-safe labels at the edge, and keep the merchant order state separate from the payment object state. That separation lets you change customer copy without corrupting reconciliation.

Example implementation record

This is an application-side record shape for go-live checklist. Keep exact request and response fields aligned with your enabled account contract when 0Base API access is released for your partner account; the point of this record is to keep product, support, and finance joined in your system.

{
  "go_live_id": "base_go_live_2026_06",
  "merchant_id": "mrc_2048",
  "scope": [
    "hosted_checkout",
    "payment_intents",
    "webhooks",
    "reports"
  ],
  "critical_tests": "passed",
  "rollback_contact": "payments_oncall",
  "launch_state": "ready_for_controlled_launch"
}

Operational scenario

A go-live checklist protects the merchant and the customer from the most common launch mistake: a payment page that looks complete before the backend, support, and finance workflows are complete.

In practice, production 0Base integrations make the happy path fast while keeping exceptions predictable: retries return the same object, delayed notifications can be repaired, expired sessions do not become mystery payments, and finance exports can be traced back to the original merchant order.

Before and after

Before 0BaseWith 0Base
Launch meant UI merged.Launch means lifecycle, notifications, reports, support, and rollback are ready.
Only happy path passed.Failure and recovery paths are required.
Finance reviewed after first incident.Finance reviews exports before launch.
Docs/UI promised more than enabled.Public claims match merchant-specific capabilities.

Evidence to keep

EvidenceWhat to store
Scope packetSurfaces, markets, assets, networks, settlement behavior, excluded items.
Access packetKeys, merchant id, capabilities, payout settings, webhooks.
Test packetSuccess/failure/expiry/idempotency/replay/report evidence.
Operations packetSupport macros, escalation path, finance export owner.
Rollback packetFeature flags, disabled states, customer/support copy.

This evidence is what makes the integration supportable at institutional scale. A developer should not need private operational knowledge to answer basic questions such as what the customer saw, which object owns the state, which event announced the change, and which ledger or report row closed the money movement.

Failure modes and recovery

Failure modeRecovery
Webhook test failsBlock launch until signature/dedupe/replay passes.
Ledger export missing expected columnsBlock finance launch scope until reports are usable.
Unsupported method appears in UIFix capability mapping and rerun launch review.
Production issue after launchDisable checkout exposure, preserve objects, communicate recovery path.

Recovery should be idempotent and explainable. When the system is uncertain, preserve the current raw status, read the latest object state, attach a support reference, and avoid changing fulfillment or finance state until a trusted terminal condition is present.

API adjacency

API areaUse it for
GET /capabilities/payment_methodsConfirm launch payment methods.
POST /webhooks/testConfirm notifications.
GET /reports/transactionsConfirm transaction report.
GET /reports/settlementConfirm settlement report.

For endpoint-level implementation, use the API reference as the source of truth for fields, enums, authentication, idempotency behavior, pagination, and response examples.

Why this matters for merchants and customers

A go-live checklist protects the first real customers. It ensures the page, backend, webhook handler, support process, finance export, and rollback path are all ready before payment traffic starts.

At scale, the value of 0Base is not only that a payment can be created. The value is that the payment can be explained later: what the customer saw, which account capabilities allowed it, which backend state changed, which notification delivered it, and which ledger or report row closed it.

Worked API path

The example below shows the implementation shape for this page. Use merchant-specific capabilities, account settings, and API responses in production; the ids and values here are illustrative.

curl -X POST https://base-api-sandbox.0bit.app/v1/webhooks/test \
  -H "Authorization: Bearer $OBIT_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ord_100045:base:v1" \
  -d '
{
    "eventType": "payment_intent.succeeded",
    "intentId": "pi_test_456"
}'

Example response shape:

{
  "object": "webhook_delivery",
  "id": "whd_test_launch",
  "event_id": "evt_test_launch",
  "event_type": "payment_intent.succeeded",
  "intent_id": "pi_test_456",
  "status": "pending",
  "attempts": 0
}

Implementation checkpoints:

  • Read account and environment state before rendering or launching the product surface.
  • Attach the returned object id to the same business record.
  • Record the request id, idempotency key, raw status, and environment.
  • Use webhook and report reads to repair delayed or missed state changes.

Data join map

This join map is the reason 0Base is infrastructure rather than a payment button. A merchant can change checkout UX, support tooling, or finance exports without losing the chain from customer action to backend state and settlement evidence.

Operator runbook

SignalCheck firstAction
Customer reports payment not updatingLook up merchant order id, 0Base object id, raw status, and latest webhook delivery.Read current object state before changing fulfillment.
Webhook delivery failedCheck delivery id, event id, attempts, last error, and handler logs.Fix the handler, replay once, and dedupe by event id.
Finance cannot match a rowCompare client reference, intent id, settlement id, report period, and export row.Move the item to reconciliation queue instead of closing by amount/date.
Launch test failsIdentify whether the failure is capability, key, webhook, status, or report related.Block launch for that scope until the failing layer has a passing evidence record.

The runbook should be available to support and finance teams before launch. A developer integration is not complete if only engineering can explain the state of a customer payment.

Developer checklist

  • Confirm exact launch scope.
  • Re-read production capabilities.
  • Verify keys and webhook endpoints.
  • Run the full lifecycle and failure matrix.
  • Have support and finance review records.
  • Prepare rollback before enabling traffic.

On this page