Test keys only: move a simulated purchase to paid, expired, failed or requires_action (authentication_required); never charges and writes no ledger row (60 per key per hour)

post/v1/billing/purchases/{id}/simulate

Request

  • Base URL: https://api.roveapi.com
  • URL: https://api.roveapi.com/v1/billing/purchases/{id}/simulate
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Request body

outcome'paid' | 'expired' | 'failed' | 'authentication_required' required

Response

Successful response (Cache-Control: no-store)

idstring uuid required
object'purchase' required
status'created' | 'open' | 'requires_action' | 'processing' | 'paid' | 'refunded' | 'disputed' | 'reversed' | 'expired' | 'canceled' | 'failed' required
livemodeboolean required
actor'owner_web' | 'api_key' | 'auto_topup' | 'legacy_link' required
api_key_idstring uuid nullable required
api_key_namestring nullable required
replayedboolean required
channel'checkout' | 'off_session' required
amount_centsinteger required
currency'usd' required
creditsinteger required

Whole credits the pack grants.

amount_refunded_centsinteger required
millicredits_reversedinteger required
millicredits_heldinteger required
retry'same_key' | 'new_key' nullable required
failure_codestring nullable required
created_atstring date-time required
paid_atstring date-time nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.