Test Payment Simulations

Endpointhttps://api.kontorion.eu/v1

Simulate payment outcomes in sandbox environments without connecting to real payment processors. Trigger specific scenarios - successful payments, failures, pending states, and disputes - to test your integration's handling of each case.

Combine with test clocks to simulate full lifecycle scenarios: create a subscription, advance time to generate an invoice, then simulate a payment failure to test your dunning flow.

List test payment simulations

GET

https://api.kontorion.eu/v1

/test-payment-simulations

Returns all payment simulations for the current sandbox

List test payment simulations › Responses

List of simulations with count

count

integer

object[]

Create a test payment simulation

POST

https://api.kontorion.eu/v1

/test-payment-simulations

Creates a new payment simulation for testing payment flows in sandbox mode

Create a test payment simulation › Request Body

outcome

string · enum

Enum values:

success

decline

insufficient_funds

expired_card

fraud

processing_error

network_error

payment_method_id

string

Create a test payment simulation › Responses

Created simulation wrapped in data envelope

created_at

string

id

string

outcome

string · enum

Enum values:

success

decline

insufficient_funds

expired_card

fraud

processing_error

network_error

payment_method_id

string

workspace_id

string

Delete a test payment simulation

DELETE

https://api.kontorion.eu/v1

/test-payment-simulations/{id}

Permanently deletes a payment simulation

Delete a test payment simulation › path Parameters

id

string · required

Simulation UUID

Delete a test payment simulation › Responses

No content

No data returned

Test Clocks Accounting

Create a test payment simulation

POST

https://api.kontorion.eu/v1

/test-payment-simulations

Creates a new payment simulation for testing payment flows in sandbox mode

Create a test payment simulation › Request Body

outcome

string · enum

Enum values:

success

decline

insufficient_funds

expired_card

fraud

processing_error

network_error

payment_method_id

string

Create a test payment simulation › Responses

Created simulation wrapped in data envelope

created_at

string

id

string

outcome

string · enum

Enum values:

success

decline

insufficient_funds

expired_card

fraud

processing_error

network_error

payment_method_id

string

workspace_id

string