noCV
BBILL-105 · Handle asynchronous results

Reconcile unknown creation outcomes by operation identity

Practice briefTaskAdvanced

The provider accepted creation but the application lost the response.

Focused work estimate
3h 30m + prerequisites
Priority in the scenario
High
Engineering practice
Reconciliation

Estimated field mix

  • Integrations50%
  • Distributed systems50%

Field percentages are editorial estimates of the ticket's engineering focus. They total 100%; they are not measured time, proficiency scores, or ownership evidence.

Your next step

Review it, then add it to your workspace.

The board opens an editable draft; nothing is saved until you confirm it. Sign-in and workspace permissions apply, and Demo boards remain ephemeral.

Project context

A fictional software vendor changes payment providers. Its application must tolerate unknown outcomes, signed callbacks, refunds, and inconsistent settlement reports.

Setup prerequisites

  • Create a local payment-provider double and synthetic orders; use test-only signatures and execute no financial transactions.

Preceding work

Complete these dependencies, or supply their agreed outputs before taking this ticket.

Acceptance criteria

  • Query the provider using the original operation identity.
  • Adopt the matching remote payment once.
  • Keep missing or mismatched results unresolved.

Implementation constraints

  • Bound query retries and elapsed reconciliation time.

Verification to include

  • Recover a matching accepted payment.
  • Reject a remote result with different amount or currency.

Deliverables

  • Unknown-outcome reconciler.

Rollout and recovery

Stop new attempts for unresolved operations; retry reconciliation explicitly.

Value of the work

For the engineer: Practice idempotent integrations, state reconciliation, and provider migration.

For the team: Provide a reviewable adapter design that protects order consistency and recovery.

Evidence boundaries

Outcome Evidence: Tests, patches, and runbooks are requested deliverables. They become Outcome Evidence only through a qualified Mission and immutable Evidence IDs.

Ownership Evidence: Independent adaptation must be observed under a declared verification policy and cite immutable Evidence IDs. Completing a planning ticket establishes no Ownership Evidence.