Skip to main content
POST
Simulate Card Transaction
Sandbox only. Triggers a simulated card spend or credit; balance and transaction history update when PayVessel processes the event.

Headers

api-key
string
required

Your Payvessel public API key

api-secret
string
required

Your Payvessel secret

Content-Type
enum<string>
required

Request content type

Available options:
application/json

Path Parameters

card_id
string<uuid>
required

PayVessel card ID

Body

application/json
amount
string
required

Transaction amount in USD (e.g. 1.50)

Example:

"1.50"

type
enum<string>
default:DEBIT

DEBIT simulates a card spend; CREDIT simulates a refund or credit

Available options:
DEBIT,
CREDIT

Response

Simulation accepted

status
boolean

Indicates whether the request succeeded

message
string

Human-readable result message

data
object

Simulation result