# 3. Set Retention Amount

# Request URL

  • {domain}/open-api/wallet/withdrawThreshold

# Request Method

  • POST

# Request Headers

Parameter Name Required Type Description
Content-Type Yes string application/json

# Request Body Parameters

Parameter Name Required Type Description
appId Yes string Application APPID
param Yes string Parameter body
sign Yes string Signature

# param Parameters

Parameter Name Required Type Length Example Description
timestamp Yes long - 1677495496979 Millisecond timestamp
mchUuid Yes string 1-32 - Merchant user UUID unique identifier
withdrawThreshold Yes long - - Retention amount - in cents (e.g. 500 THB: 50000)

# Request Example

# Request Body

{
  "appId": "733b887a4a784708bb369524db5b6ded",
  "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
  "param": "{\"timestamp\":1715595802,\"mchUuid\":\"JT1095595801938341100\",\"withdrawThreshold\":12000}"
}

How to construct request body


# Response Parameters

Parameter Name Type Description
code integer response code
message string response message
data Object data

# data Parameters

Parameter Name Type Description
uuid string Wallet user UUID unique identifier
mchUuid string Merchant user UUID unique identifier
withdrawThreshold long Retention amount (in cents, e.g. 500 THB: 50000 )

# Response Example

# Response Data Body

{
  "code": 10000,
  "message": "Success",
  "data": {
    "uuid": "U39493938858584",
    "mchUuid": "JT1095595801938341100",
    "withdrawThreshold": 1200
  }
}

Code Collection

# Failed Response Example

{
  "code": 1002,
  "message": "merchant white ip forbidden"
}