Skip to main content
POST
Fund or Withdraw Card Balance

Authorizations

X-Api-Key
string
header
required

Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.

X-Api-Secret
string
header
required

Your API secret (yativo_sk_...), shown once when the key is created.

Headers

Idempotency-Key
string
required

A unique string per request to ensure idempotent processing.

Body

application/json
employee_id
string
required
Example:

"emp_456"

action
enum<string>
required
Available options:
fund,
withdraw
Example:

"fund"

amount
number
required

USD, at least 0.01.

Required range: x >= 0.01
Example:

500

account_id
string | null

One of the employee's accounts[].account_id.

Response

The updated balance

status
string
Example:

"success"

status_code
integer
Example:

200

message
string
Example:

"Request successful"

data
object