9x Paynet OpenAPI

Unified entry

POST /api/entry — one URL, method selects the capability

Request

POST /api/entry
Content-Type: application/json

The body is a flat JSON object. Common fields (almost every method):

FieldMeaning
app_idApplication id
methodCapability name, e.g. order.query
formatAlways JSON
charsetAlways UTF-8
sign_typeAlways RSA2
versione.g. 1.0
timestampMillisecond timestamp as a string
signApp RSA2 signature (Base64)

Business fields depend on method: admin calls may include scope_id / key_id; payments may include merchant_order_no, order_amount, and so on. Full enums and examples: API Reference.

Response envelope

HTTP status is usually 200. Success is determined by JSON:

{
  "code": "0",
  "msg": "success",
  "data": { },
  "psn": "...",
  "sign": "..."
}
FieldMeaning
code"0" means success; otherwise a business / admission error
msgHuman-readable message
dataObject on success; often null on failure
psnPlatform serial number
signPlatform RSA2 reply signature (when present)

Do not rely on HTTP status alone — use code.

Merchant context

Most payment and Access Key admin requests include:

  • institution_no
  • merchant_no
  • store_no

These must match stores opened to the app (openApp). When an Access Key is bound to a store, morph 2 also checks that binding.

On this page