---
title: "[Sandbox] Top up account balance"
method: POST
path: "/sandbox/merchant/topup"
---

# \[Sandbox\] Top up account balance

`POST /sandbox/merchant/topup`

## Request

- Base URL: `https://api-sandbox.straitsx.com/v1`
- URL: `https://api-sandbox.straitsx.com/v1/sandbox/merchant/topup`
- Auth: API key in header `X-XFERS-APP-API-KEY`

[Available in Sandbox environment only] Add funds to your sandbox account for testing purposes.

## Headers

- `X-XFERS-APP-API-KEY` string, required
- `X-PUBLIC-KEY-ID` string
- `X-TIMESTAMP` string
- `X-NONCE` string
- `X-SIGNATURE` string

## Request body

- object
  - `data` object
    - `attributes` object, required
      - `currency` 'SGD' | 'USD', required: Currency to top up
      - `amount` string, required: Amount to add to the account (up to 2 decimal places). Must be a positive number.<br>Regex: `/^(?!0(\.0+)?$)([1-9]\d*(\.\d+)?|0\.\d*[1-9]\d*)$/`

## Response `200`

200

- object
  - `data` object[]
    - `id` string: Account balance record ID.
    - `type` string: Request type.
    - `attributes` object
      - `amount` string: Updated balance amount after top up.
      - `currency` string: Currency of the balance.

---

[API](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url.md) - [All operations](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url/llms.txt) - [OpenAPI document](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url/revisions/d17239d67150?raw)