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

# [Sandbox] Top up account balance

`POST /sandbox/merchant/topup`

[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.net/straitsx/apis/straitsx-sandbox-base-url.md) · [All operations](https://skmtc.net/straitsx/apis/straitsx-sandbox-base-url/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/straitsx/straitsx-sandbox-base-url/revisions/9ceee2969aeb/schema)