Transaction Meta

Retrieve supported currencies, environments, fee structures, and transaction limits

Retrieve the transaction metadata for the authenticated account. This includes supported currencies, environments, fee structures, and minimum/maximum transaction amounts per currency.

Use this endpoint to discover which currencies and environments are available before initiating transactions or calculating fees.

Endpoint

GET /transactions/meta

Access	Requirement
Authenticated	Yes
Required Scope	`wapi-transactions-retrieve`, or `wapi-transactions-all`
Rate Limit	60 requests per minute

Request

Headers

Header	Value
`Accept`	`application/json`
`Authorization`	`Bearer <access_token>`
`X-WAPI-Key`	`wapi_live_<kid>_<secret>` or `wapi_test_<kid>_<secret>`

Send exactly one of Authorization or X-WAPI-Key.

No query parameters or request body required.

Responses

200 OK

{
  "message": "OK",
  "data": {
    "currencies": [
      "TTD",
      "USD"
    ],
    "environments": [
      "live",
      "sandbox"
    ],
    "fee_structures": [
      "customer_pay",
      "merchant_absorb",
      "split"
    ],
    "totals": {
      "TTD": {
        "minimum": 5,
        "maximum": 20400
      },
      "USD": {
        "minimum": 0.74,
        "maximum": 3000
      }
    }
  }
}

Metadata Fields

Field	Type	Description
`data.currencies`	array	Supported currency codes for the authenticated account
`data.environments`	array	Available environments: `"live"`, `"sandbox"`
`data.fee_structures`	array	Valid fee structure values: `"customer_pay"`, `"merchant_absorb"`, `"split"`
`data.totals`	object	Per-currency minimum and maximum transaction limits
`data.totals.{currency}.minimum`	number	Minimum transaction amount for this currency
`data.totals.{currency}.maximum`	number	Maximum transaction amount for this currency

The available currencies and environments depend on the authenticated account's gateway configuration for the platform.

401 Unauthorized

{
  "message": "Unauthorized"
}

403 Forbidden

{
  "message": "Invalid scope(s) provided."
}

Example

curl -X GET "https://ttsb.wipayfinancial.com/wapi/transactions/meta" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access_token>"

On this page