Skip to main content
POST
/
partner
/
sandbox
/
simulate-transaction
Simulate a card transaction
curl --request POST \
  --url https://api.contro.me/v1/partner/sandbox/simulate-transaction \
  --header 'Content-Type: application/json' \
  --header 'x-contro-api-key: <api-key>' \
  --data '
{
  "cardId": "card_sandbox_123",
  "amount": 2500,
  "currency": "USD",
  "merchantName": "Test Coffee Shop"
}
'
{
  "transactionId": "<string>",
  "amount": 123,
  "currency": "<string>",
  "status": "<string>"
}

Authorizations

​
x-contro-api-key
string
header
required

Partner API key (sk_live_* for production, sk_test_* for sandbox)

Body

application/json
​
cardId
string
required

ID of the sandbox card

Minimum string length: 1
Example:

"card_sandbox_123"

​
amount
number
required

Transaction amount in minor units (cents)

Example:

2500

​
currency
string
default:USD

ISO 4217 currency code

Example:

"USD"

​
merchantName
string
default:Sandbox Merchant

Simulated merchant name

Example:

"Test Coffee Shop"

Response

Transaction simulated

​
transactionId
string
required
​
amount
number
required
​
currency
string
required
​
status
string
required