Skip to main content
POST
Simulate a collection (sandbox only)

Authorizations

Authorization
string
header
required

Your Jenzy API key: Authorization: Bearer jz_live_…

Body

application/json
amount
required

An exact decimal string in the asset’s major unit, with at most the asset’s decimals ("250000.00", "12.5"), or a JSON integer of whole units. Fractional JSON numbers are rejected — send a string. Parse with a decimal library, never a float.

Example:

"250000.00"

asset
string
required

An asset code as GET /v2/assets lists it — uppercase, never compound (KES, USDT; never USDT-TRON). Network and rail live on the payment object.

Minimum string length: 1
Example:

"KES"

Response

Accepted, not yet credited. id is null (and status is pending) when the sandbox’s answer was lost — the deposit may still land, so poll rather than retry.

id
string | null
required

The sandbox deposit id, or null when the request reached the sandbox but its answer was lost — the deposit may still land. Do NOT retry on null; poll GET /v2/collections.

asset
string
required

An asset code as GET /v2/assets lists it — uppercase, never compound (KES, USDT; never USDT-TRON). Network and rail live on the payment object.

Minimum string length: 1
Example:

"KES"

amount
string
required
Example:

"1000.00"

status
string
required

processing at accept, or pending when the answer was lost; either way the credit appears in GET /v2/collections within about a minute.

Example:

"processing"