Skip to main content
A confirm ended without a placed order. code is the gate’s reason (vault_approval_required, byoc_approval_required, sandbox_mode, per_txn_max_exceeded, …), the merchant’s (items_unavailable, pos_cart_validation, address_changed), or a refusal of the payment itself (unsupported_currency, currency_changed, no_cart). An approval pause carries approval_url and retryable: true: show the link, then send the same confirm again. A payment refusal carries retryable too, and false means the same confirm fails the same way. A failure Agentcard cannot name carries the step it stopped at, prepare or place, as code, with message null. charge_status is the only answer to whether money moved. total_cents is the US dollar amount, in cents, that Agentcard judged the confirm by. A cart priced in another currency also carries the merchant’s own figure in merchant_total_cents and merchant_currency, as on order.placed. Both merchant fields are null for a cart priced in US dollars. A confirm that failed before Agentcard priced the cart carries null in total_cents as well. refusal_code is null on nearly every failure, where the reason to act on is code. It is set beside code: card_recovery_pending, the state where a prior card is still being recovered and the same confirm can be retried, and it then carries the merchant’s own reason to fix first, such as pos_cart_validation, items_unavailable or address_changed. It is also address_undeliverable when the store refused the shipping address, and in that case address_issue names what the carrier found wrong and suggested_address holds the one address it suggests. All three are null otherwise.