Skip to main content
POST
Simulate a bank pay-in
Provider sandbox on this deployment. Our backend targets the bank provider’s sandbox: bank details are test details, no real transfer settles, and settlement lands on a testnet (read network from GET /v1/config). Known limits: only the EUR/IBAN rail is wired for the simulated pay-in, and identity checks run on test-mode applicants. Every response says which environment answered in its environment field.

Authorizations

Authorization
string
header
required

Your API key, issued by us and shown once at creation.

Path Parameters

id
string
required

The virtual account id.

Example:

"va_1"

Body

application/json
amount
string
required

The pay-in amount, verbatim, in the account's currency (major units).

Pattern: ^\d+(\.\d+)?$
Example:

"100"

accountHolderName
string

Depositor name on the simulated statement. Empty or absent means "Rheon test depositor".

reference
string

Reference line on the simulated statement. Empty or absent means "rheon test deposit".

Response

The provider's simulation answer.

environment
enum<string>
required

Which environment answered. sandbox: at least one money upstream is the provider's sandbox - no real money moves there, and the card corridor is the sandbox's asset (read GET /v1/config), not the documented production one. production: every configured upstream is real. Derived from the configured upstream hosts at boot, never a flag.

Available options:
sandbox,
production
Example:

"sandbox"

testEnvironment
boolean
required

Always true: nothing recorded off these endpoints is a real event.

result
any
required

The provider's own simulation answer, verbatim.