API conventions

Base URL

Production gateway:

https://api.ucashier.ink

Test gateway:

https://api-beta.ucashier.ink

Open APIs use POST + application/json. Full URL = gateway + /api/public/....

Request contract

  • Field names are case-sensitive; pass values according to the types declared in the parameter table.
  • Use a unique merchantOrderNo per transaction.
  • The signature source string uses fields marked Sign = Yes. The algorithm is HMAC-MD5 (see Signing).

Response format

Every API returns this envelope. code is the string "100000" on success; any other value is failure.

{
  "code": "100000",
  "message": "Success",
  "data": { },
  "requestId": "..."
}
FieldTypeDescription
codestringStatus; "100000" means success
messagestringStatus text
dataobjectBusiness payload; may be empty when the request fails
requestIdstringRequest id

Common error codes: see Parameter lookup.