Skip to main content
GET
​
string
required
The authorization id.
​
string
awaiting_approval, approved, submitted_on_device (hosted-form processors only; no processor evidence exists), declined, or expired.
​
string
user_approval when the user approves in the Vault, autopilot when Agentcard pays without asking the user. An autopilot authorization carries no approvalUrl and names the permission that paid in grant_id. See Enable auto-approval.
​
string
Present once Agentcard tried to pay without asking: dispatching, succeeded, declined, not_submitted (the purchase went back to waiting for the user), outcome_unknown, or action_required (the user’s bank asked them to confirm the payment).
​
string
unverified_origin when the purchase waits for the user because the create carried no checkout_origin, with a sentence in execution_detail. Absent otherwise.
​
object | null
On an auto-approved purchase with charged_kind: "none": what your app reported the merchant charged, refunded, or declined, with the net_amount. Null on any other purchase. See Report a checkout outcome.
​
object
On approved in token mode: the processor’s response to replay into the paused request.
​
object
On approved in cse mode: the encrypted card fields to write into the paused body, plus remove for sibling keys to drop.
​
integer | null
The amount, in the currency’s smallest unit, with currency and amount_display (the human form, $23.06). Null until an authority names one.
​
string
Who named the amount: processor (the payment request, or the Stripe intent read back), agent (the amount your agent sent), page (the total read off the checkout page), or none. The highest known wins, and the processor’s is read right before the card is sent.
​
boolean | null
Whether what the processor charged matches the approved amount. Null when there was nothing to compare.
​
string | null
captured, authorized, none, or null.
​
string
On declined: user_declined, amount_mismatch, intent_not_confirmable, processor_refused (with psp_error_code), or processor_declined (the processor declined an auto-approved purchase).
​
object
Optional on a Razorpay processor_refused result: bounded reason, source, step, payment_id, and order_id identifiers reported by the processor. Raw response bodies and descriptions are excluded. Older records may not contain these details.
​
boolean
True when a device may already have sent the card. On expired, read settlement for what the processor says.
​
object | null
Whether the charge settled, read back from the processor by Agentcard itself once the authorization finished. status is settled (the processor reports a succeeded payment; processor_reference is its charge or intent, settled_amount what it collected), not_settled (no charge was made: reason is processor_canceled, confirm_failed with processor_error_code, or not_confirmed), or unknown with a reason (check_pending, awaiting_customer_action, processor_processing, awaiting_merchant_capture, processor_unreachable, processor_refused_read, processor_reply_malformed, no_processor_reference, processor_reference_incomplete). final is true once Agentcard will not check again; while false, poll or wait for the checkout_authorization.settled / settlement_unconfirmed webhook. message says it in a sentence. Only a Stripe PaymentIntent confirm can be read back; every other request is unknown / no_processor_reference, final at once. Null while awaiting approval, on a decline, and on an expiry where no device ever held the card.
An approval is not an order. Confirm the order with the merchant before acting on it. A settled charge is not an order either: it tells you the money moved when the merchant page never showed a receipt, and the merchant’s order is still where the purchase is confirmed. processor_refused means the device reported a rejected processor request. A generic code such as Razorpay’s BAD_REQUEST_ERROR does not establish an issuer decline or prove that nothing was charged. Check the merchant payment status before starting another attempt.