`market payment-sync`

Read the provider’s checkout and credit only a paid intent.

Exact invocation

handtohuman market payment-sync <INTENT_ID>

Inputs and options

<INTENT_ID>

Required. An intent that already has a checkout. One without a checkout is refused, naming the command that opens one.

STADO_INTEGRATION_API_URL

The wisent-integrations origin. Provide its bearer with HANDTOHUMAN_INTEGRATION_TOKEN or the Stado integration bearer field token, read under a dedicated consumer grant after resolving the Skarbiec route. Alternatively, HANDTOHUMAN_STRIPE_KEY_FILE names an owner-only Stripe key file for direct access.

Output and state effect

Result

The provider’s status, payment_status, payment id, amount collected and currency, alongside the ledger’s intent and whether this call credited it. A balance is credited only on payment_status: paid, against the provider payment id held unique by the ledger. Reading a paid session twice credits once.

Serialization

Prints the sync result as JSON by default, or path-and-value lines with --text.

Refusals

Refuses an intent with no checkout, naming payment-checkout.
Refuses to credit when Stripe reports the session paid but returns no payment id.
Refuses when the amount Stripe collected differs from the intent, naming both figures.
Reports an unpaid or expired session without touching the ledger.