Skip to main content
Use this endpoint to test card spend and transaction history without real merchant charges. PayVessel records the simulation via webhook and updates the card balance.
Sandbox only. Not exposed in production. Your integration should only call this when using sandbox API keys and https://sandbox.payvessel.com.

​
How it works

  1. Create and activate a card (Create a Card, then poll Get a Card until ACTIVE).
  2. POST a simulation with amount and type (DEBIT or CREDIT).
  3. PayVessel processes the event: the transaction is recorded and the card balance is refreshed.
  4. Verify with Get Card Transactions.

​
Request fields

FieldRequiredDescription
amountYesUSD amount (e.g. "1.50")
typeNoDEBIT (default) = spend; CREDIT = refund/credit

​
When to use

  • End-to-end testing of spend notifications in your app
  • QA of transaction lists and balances in sandbox
  • Demo environments without real card networks

​
Limitations

  • Card must be ACTIVE (not pending activation)
  • Balance shown in the response may change again after the webhook syncs
  • Production requests return a validation error

API Reference: Try it

Run this endpoint in the browser (sandbox)