Skip to main content
The PreauthSignals endpoint returns the predicted likelihood that a transaction will succeed, alongside verified ownership of the card and recommended retry timing. It accepts either an authenticated Method Account or raw card data, with optional purchase context to improve the prediction.
Public preview. PreauthSignals is in public preview. Contact your Method CSM to request access.

​
Data access

The fields returned by PreauthSignals are split across two tiers:
  • Identifier-based fields — verified_ownership and card_standing run entirely on the identifiers passed in the request (an account_id, or card.bin6, card.last4, card.first_name, card.last_name, and card.phone) and return a match result and the card’s open/closed status. Available to all customers by default, with no additional data access required.
  • Predictive components — success_likelihood and optimal_retry_date depend on richer underlying data that not every customer is provisioned for. When the required data is not available, the endpoint returns null as the value for both success_likelihood and optimal_retry_date. This is a normal response state, not an error or a fallback.
The PreauthSignals endpoint is available as a:
TypeUse-Case
ProductOn-Demand assessment of a transaction attempt for a given card or account.

​
PreauthSignals Object

{
  "id": "preauth_qV7kRaFm4JNxw",
  "account_id": "acc_4m9amk4KFiaQX",
  "status": "completed",
  "verified_ownership": "match",
  "card_standing": "open",
  "success_likelihood": 0.87,
  "optimal_retry_date": "2026-06-02",
  "error": null,
  "metadata": null,
  "created_at": "2026-05-28T14:00:00.000Z",
  "updated_at": "2026-05-28T14:00:00.180Z"
}